Skip to Content
FontegoDocs

CLI commands

Every fontego command, with its arguments, options and the API call it makes.

Every command of fontego. The ones under This machine and Synced folders are built into the CLI; the rest come from the server, which publishes them at GET /v1/commands, so fontego help on your machine always matches your Fontego.

Every command accepts --json and --instance ALIAS. FONTEGO_URL with FONTEGO_TOKEN uses that server and token instead of a saved sign-in.

This machine

fontego login

Sign in to a Fontego: opens the browser (or shows a code to type on another device).

fontego login [TARGET] [--device] [--token TOKEN] [--alias ALIAS]
Argument
TARGETAn alias you already have, or the address of a Fontego. Optional.
Option
--deviceShow a code to type in a browser on another device (no browser here).
--token TOKENSign in with a token instead, for scripts and CI (or set FONTEGO_TOKEN).
--alias ALIASThe short name to use for this Fontego (default: from its name).
--jsonMachine-readable output.

fontego logout

Sign out of a Fontego (its session closes on the server too); --all: of every one.

fontego logout [ALIAS] [--all]
Argument
ALIASOptional.
Option
--allEvery Fontego of this machine.
--jsonMachine-readable output.

fontego sessions

The Fontegos of this machine: account, whether signed in, and when each session ends.

fontego sessions
Option
--jsonMachine-readable output.

fontego sessions rename

Give a Fontego another alias.

fontego sessions rename ALIAS NEW
Argument
ALIAS
NEW
Option
--jsonMachine-readable output.

fontego sessions forget

Sign out of a Fontego and take it off this machine's list.

fontego sessions forget ALIAS
Argument
ALIAS
Option
--jsonMachine-readable output.

fontego use

Choose the Fontego commands go to by default.

fontego use ALIAS
Argument
ALIAS
Option
--jsonMachine-readable output.

fontego open

Open the web app, already signed in.

fontego open [WORKSPACE] [--print]
Argument
WORKSPACEOptional.
Option
--printOnly show the link (it works once, for two minutes).
--jsonMachine-readable output.

fontego help

This help; with a command, its details; --agent: how to use fontego, for an AI agent.

fontego help [COMMAND...] [--agent]
Argument
COMMANDOptional.
Option
--agentMarkdown for an AI agent.
--jsonMachine-readable output.

fontego setup

Teach the AI agents on this machine to use fontego: a short skill in the folders they read.

fontego setup [--remove] [--print]
Option
--removeTake the skill away again.
--printPrint the skill (SKILL.md) instead, to put it somewhere else.
--jsonMachine-readable output.

fontego version

The version of this CLI.

fontego version
Option
--jsonMachine-readable output.

Synced folders

fontego clone

Make DIR (default ./WORKSPACE) a synced copy of the workspace.

fontego clone WORKSPACE [DIR]
Argument
WORKSPACE
DIROptional.
Option
--jsonMachine-readable output.

Connect a folder that already has files (default: this one) and send them up.

fontego link WORKSPACE [DIR]
Argument
WORKSPACE
DIROptional.
Option
--jsonMachine-readable output.

fontego status

What changed here since the last sync, and what the ignore rules keep here (works offline).

fontego status [DIR] [--ignored]
Argument
DIROptional.
Option
--ignoredList what the ignore rules keep here (--json always does).
--jsonMachine-readable output.

fontego check-ignore

Which ignore rule keeps a path from syncing, if any, like git check-ignore -v (works offline).

fontego check-ignore PATH
Argument
PATHA file or folder inside a synced folder.
Option
--jsonMachine-readable output.

fontego sync

Sync once: bring down, send up.

fontego sync [DIR]
Argument
DIROptional.
Option
--jsonMachine-readable output.

fontego watch

Keep syncing: seconds after you edit, and when others commit; waits while offline.

fontego watch [DIR]
Argument
DIROptional.
Option
--jsonMachine-readable output.

fontego conflicts

Conflict copies waiting to be merged by hand (works offline).

fontego conflicts [DIR]
Argument
DIROptional.
Option
--jsonMachine-readable output.

Explore

fontego workspaces

The workspaces you can see, with your role.

fontego workspaces [--category CATEGORY]
Option
--category CATEGORYOnly this category.
--jsonMachine-readable output: exactly what the API answers.

Calls GET /v1/workspaces.

fontego workspace info

A workspace: description, category, your role and its last change.

fontego workspace info WORKSPACE

Also: fontego info.

Argument
WORKSPACE
Option
--jsonMachine-readable output: exactly what the API answers.

Calls GET /v1/workspaces/{workspace}.

fontego members

Who is in a workspace, with which role.

fontego members WORKSPACE
Argument
WORKSPACE
Option
--jsonMachine-readable output: exactly what the API answers.

Calls GET /v1/workspaces/{workspace}/members.

fontego ls

List a folder.

fontego ls WORKSPACE [PATH] [-r] [--rev REV]
Argument
WORKSPACE
PATHFolder to list (default: the top). Optional.
Option
-r, --recursiveEvery file below the folder.
--rev REVAs it was at this commit.
--jsonMachine-readable output: exactly what the API answers.

Calls GET /v1/workspaces/{workspace}/tree.

fontego cat

Print a file.

fontego cat WORKSPACE PATH [--rev REV]
Argument
WORKSPACE
PATH
Option
--rev REVAs it was at this commit.
--jsonMachine-readable output: exactly what the API answers.

Calls GET /v1/workspaces/{workspace}/files/{+path}.

fontego log

History, newest first.

fontego log WORKSPACE [PATH] [--limit N]
Argument
WORKSPACE
PATHOnly changes to this file or folder. Optional.
Option
--limit NHow many commits (default 20). Default: 20.
--jsonMachine-readable output: exactly what the API answers.

Calls GET /v1/workspaces/{workspace}/history.

Find text in the workspace's files.

fontego search WORKSPACE TEXT [--path FOLDER] [--limit N]
Argument
WORKSPACE
TEXT
Option
--path FOLDEROnly inside this folder.
--limit NAt most this many lines (default 100).
--jsonMachine-readable output: exactly what the API answers.

Calls GET /v1/workspaces/{workspace}/search.

Write

fontego write

Write a whole file: a new one, or an edit of the version --base names.

fontego write WORKSPACE PATH [CONTENT] [--base HASH] [--message TEXT]
Argument
WORKSPACE
PATH
CONTENTThe whole new content. Left out, it is read from stdin.
Option
--base HASHHash of the version you edit (fontego cat WORKSPACE PATH --json); left out, only a new file is written.
-m, --message TEXTWhat changed (the commit message).
--jsonMachine-readable output: exactly what the API answers.

Calls PUT /v1/workspaces/{workspace}/files/{+path}.

fontego rm

Delete a file, if it is still the version --base names.

fontego rm WORKSPACE PATH [--base HASH] [--message TEXT]
Argument
WORKSPACE
PATH
Option
--base HASHHash of the version you start from (fontego cat WORKSPACE PATH --json).
-m, --message TEXTWhat changed (the commit message).
--jsonMachine-readable output: exactly what the API answers.

Calls DELETE /v1/workspaces/{workspace}/files/{+path}.

fontego mv

Move or rename a file, if it is still the version --base names.

fontego mv WORKSPACE FROM TO [--base HASH] [--message TEXT]
Argument
WORKSPACE
FROM
TO
Option
--base HASHHash of the version you start from (fontego cat WORKSPACE PATH --json).
-m, --message TEXTWhat changed (the commit message).
--jsonMachine-readable output: exactly what the API answers.

Calls POST /v1/workspaces/{workspace}/move.

Workspaces

fontego workspace create

Create a workspace, empty, from a template or from a Git repository; you become its admin.

fontego workspace create WORKSPACE [--name NAME] [--description TEXT] [--category CATEGORY] [--template NAME] [--git URL] [--branch BRANCH] [--no-history]
Argument
WORKSPACEIts id: lowercase letters, digits and dashes.
Option
--name NAMEName people see.
--description TEXTWhat it is for.
--category CATEGORYCategory it is listed under.
--template NAMEStart from a template (fontego workspace templates).
--git URLImport a Git repository this server can reach (https), with its history.
--branch BRANCHWith --git: the branch to import (default: the repository's own).
--no-historyWith --git: only its last version, as one commit.
--jsonMachine-readable output: exactly what the API answers.

Calls POST /v1/workspaces. Only server admins can run it.

fontego workspace templates

The templates a new workspace can start from.

fontego workspace templates
Option
--jsonMachine-readable output: exactly what the API answers.

Calls GET /v1/templates. Only server admins can run it.

fontego workspace edit

Change a workspace's name, description or category.

fontego workspace edit WORKSPACE [--name NAME] [--description TEXT] [--category CATEGORY]
Argument
WORKSPACE
Option
--name NAMEName people see.
--description TEXTWhat it is for.
--category CATEGORYCategory it is listed under.
--jsonMachine-readable output: exactly what the API answers.

Calls PATCH /v1/workspaces/{workspace}.

fontego members set

Give someone with an account a role in a workspace.

fontego members set WORKSPACE EMAIL ROLE
Argument
WORKSPACE
EMAIL
ROLEreader, editor or admin.
Option
--jsonMachine-readable output: exactly what the API answers.

Calls PUT /v1/workspaces/{workspace}/members/{email}.

fontego members remove

Take someone out of a workspace.

fontego members remove WORKSPACE EMAIL
Argument
WORKSPACE
EMAIL
Option
--jsonMachine-readable output: exactly what the API answers.

Calls DELETE /v1/workspaces/{workspace}/members/{email}.

fontego workspace paths

What only admins can write, and what nobody can, in a workspace.

fontego workspace paths WORKSPACE
Argument
WORKSPACE
Option
--jsonMachine-readable output: exactly what the API answers.

Calls GET /v1/workspaces/{workspace}/paths.

fontego workspace paths protect

Protect a path: only the workspace's admins can write it.

fontego workspace paths protect WORKSPACE PATTERN
Argument
WORKSPACE
PATTERNLike /AGENTS.md (any folder) or .claude/ (everything under it); quote it.
Option
--jsonMachine-readable output: exactly what the API answers.

Calls PUT /v1/workspaces/{workspace}/paths/protected/{+pattern}.

fontego workspace paths unprotect

Stop protecting a path.

fontego workspace paths unprotect WORKSPACE PATTERN
Argument
WORKSPACE
PATTERNLike /AGENTS.md (any folder) or .claude/ (everything under it); quote it.
Option
--jsonMachine-readable output: exactly what the API answers.

Calls DELETE /v1/workspaces/{workspace}/paths/protected/{+pattern}.

fontego workspace paths reject

Reject a path: nobody can write it, not even admins.

fontego workspace paths reject WORKSPACE PATTERN
Argument
WORKSPACE
PATTERNLike /AGENTS.md (any folder) or .claude/ (everything under it); quote it.
Option
--jsonMachine-readable output: exactly what the API answers.

Calls PUT /v1/workspaces/{workspace}/paths/rejected/{+pattern}. Only server admins can run it.

fontego workspace paths unreject

Stop rejecting a path.

fontego workspace paths unreject WORKSPACE PATTERN
Argument
WORKSPACE
PATTERNLike /AGENTS.md (any folder) or .claude/ (everything under it); quote it.
Option
--jsonMachine-readable output: exactly what the API answers.

Calls DELETE /v1/workspaces/{workspace}/paths/rejected/{+pattern}. Only server admins can run it.

fontego workspace paths reset

Go back to the instance's default protected and rejected paths.

fontego workspace paths reset WORKSPACE [--kind KIND]
Argument
WORKSPACE
Option
--kind KINDOnly protected, or only rejected.
--jsonMachine-readable output: exactly what the API answers.

Calls DELETE /v1/workspaces/{workspace}/paths.

Account

fontego whoami

Who you are on this Fontego, and with which token.

fontego whoami
Option
--jsonMachine-readable output: exactly what the API answers.

Calls GET /v1/me.

fontego password-reset

Ask for a link to set a new password, by mail.

fontego password-reset EMAIL
Argument
EMAIL
Option
--jsonMachine-readable output: exactly what the API answers.

Calls POST /v1/password-reset.

Server admin

fontego admin users

Everyone with an account on this Fontego.

fontego admin users
Option
--jsonMachine-readable output: exactly what the API answers.

Calls GET /v1/admin/users. Only server admins can run it.

fontego admin users invite

Invite someone: they get a link to set their password.

fontego admin users invite EMAIL [--name NAME] [--admin]
Argument
EMAIL
Option
--name NAMETheir name, as others will see it.
--adminMake them a server admin.
--jsonMachine-readable output: exactly what the API answers.

Calls POST /v1/admin/users/invitations. Only server admins can run it.

fontego admin users resend

Send a new invitation link; the earlier one stops working.

fontego admin users resend EMAIL
Argument
EMAIL
Option
--jsonMachine-readable output: exactly what the API answers.

Calls POST /v1/admin/users/{email}/invitation. Only server admins can run it.

fontego admin users disable

Stop someone from signing in; closes their sessions and tokens.

fontego admin users disable EMAIL
Argument
EMAIL
Option
--jsonMachine-readable output: exactly what the API answers.

Calls POST /v1/admin/users/{email}/disable. Only server admins can run it.

fontego admin users enable

Let someone who was disabled sign in again.

fontego admin users enable EMAIL
Argument
EMAIL
Option
--jsonMachine-readable output: exactly what the API answers.

Calls POST /v1/admin/users/{email}/enable. Only server admins can run it.

fontego admin users add

Create an account for tokens only, without a password (to invite a person: admin users invite).

fontego admin users add EMAIL [--name NAME] [--admin]
Argument
EMAIL
Option
--name NAMETheir name, as others will see it.
--adminMake them a server admin.
--jsonMachine-readable output: exactly what the API answers.

Calls POST /v1/admin/users. Only server admins can run it.

fontego admin tokens create

Create a token for someone, or for their agent (shown once).

fontego admin tokens create EMAIL [--label LABEL] [--agent]
Argument
EMAIL
Option
--label LABELWhat it's for: a machine, an agent.
--agentA token for their agent, so the log tells them apart.
--jsonMachine-readable output: exactly what the API answers.

Calls POST /v1/admin/users/{email}/tokens. Only server admins can run it.

fontego admin mail

How this Fontego sends mail.

fontego admin mail
Option
--jsonMachine-readable output: exactly what the API answers.

Calls GET /v1/admin/mail. Only server admins can run it.

fontego admin mail outbox

Messages waiting for you to pass on, with their links.

fontego admin mail outbox
Option
--jsonMachine-readable output: exactly what the API answers.

Calls GET /v1/admin/mail/outbox. Only server admins can run it.

fontego admin mail test

Send a test message, to check the SMTP settings.

fontego admin mail test EMAIL
Argument
EMAIL
Option
--jsonMachine-readable output: exactly what the API answers.

Calls POST /v1/admin/mail/test. Only server admins can run it.

fontego admin settings

This Fontego's settings, and where each comes from.

fontego admin settings
Option
--jsonMachine-readable output: exactly what the API answers.

Calls GET /v1/admin/settings. Only server admins can run it.

fontego admin settings get

One setting, and where it comes from.

fontego admin settings get KEY
Argument
KEYFrom fontego admin settings: displayName, smtp.host...
Option
--jsonMachine-readable output: exactly what the API answers.

Calls GET /v1/admin/settings/{key}. Only server admins can run it.

fontego admin settings set

Change a setting at once.

fontego admin settings set KEY [VALUE]
Argument
KEYFrom fontego admin settings: displayName, smtp.host...
VALUEThe new value. Left out, it is asked for without showing what you type.
Option
--jsonMachine-readable output: exactly what the API answers.

Calls PUT /v1/admin/settings/{key}. Only server admins can run it.

fontego admin settings reset

Put a setting back to the config's value or the default.

fontego admin settings reset KEY
Argument
KEYFrom fontego admin settings: displayName, smtp.host...
Option
--jsonMachine-readable output: exactly what the API answers.

Calls DELETE /v1/admin/settings/{key}. Only server admins can run it.

fontego admin users remove

Delete an account at once (its history stays); needs --yes.

fontego admin users remove EMAIL [--yes]
Argument
EMAIL
Option
--yesYes, delete it: this can't be undone.
--jsonMachine-readable output: exactly what the API answers.

Calls DELETE /v1/admin/users/{email}. Only server admins can run it.

fontego admin users grant-admin

Make someone a server admin.

fontego admin users grant-admin EMAIL
Argument
EMAIL
Option
--jsonMachine-readable output: exactly what the API answers.

Calls PUT /v1/admin/users/{email}/admin. Only server admins can run it.

fontego admin users revoke-admin

Stop someone being a server admin.

fontego admin users revoke-admin EMAIL
Argument
EMAIL
Option
--jsonMachine-readable output: exactly what the API answers.

Calls DELETE /v1/admin/users/{email}/admin. Only server admins can run it.

fontego admin users reset-password

Send someone a link to set a new password.

fontego admin users reset-password EMAIL
Argument
EMAIL
Option
--jsonMachine-readable output: exactly what the API answers.

Calls POST /v1/admin/users/{email}/password-reset. Only server admins can run it.

fontego admin sessions

Open sessions of everyone (browsers and CLIs).

fontego admin sessions [--user EMAIL]
Option
--user EMAILOnly this person's.
--jsonMachine-readable output: exactly what the API answers.

Calls GET /v1/admin/sessions. Only server admins can run it.

fontego admin sessions close

Close someone's session at once.

fontego admin sessions close ID
Argument
IDFrom fontego admin sessions.
Option
--jsonMachine-readable output: exactly what the API answers.

Calls DELETE /v1/admin/sessions/{id}. Only server admins can run it.

fontego admin tokens

Tokens that still work, of everyone.

fontego admin tokens [--user EMAIL]
Option
--user EMAILOnly this person's.
--jsonMachine-readable output: exactly what the API answers.

Calls GET /v1/admin/tokens. Only server admins can run it.

fontego admin tokens revoke

Revoke a token at once.

fontego admin tokens revoke ID
Argument
IDFrom fontego admin tokens.
Option
--jsonMachine-readable output: exactly what the API answers.

Calls DELETE /v1/admin/tokens/{id}. Only server admins can run it.

fontego admin workspaces

Every workspace, with its members and last change.

fontego admin workspaces
Option
--jsonMachine-readable output: exactly what the API answers.

Calls GET /v1/admin/workspaces. Only server admins can run it.

fontego admin workspaces archive

Archive a workspace: hidden and read-only, until brought back.

fontego admin workspaces archive WORKSPACE
Argument
WORKSPACE
Option
--jsonMachine-readable output: exactly what the API answers.

Calls PUT /v1/admin/workspaces/{workspace}/archived. Only server admins can run it.

fontego admin workspaces unarchive

Bring an archived workspace back.

fontego admin workspaces unarchive WORKSPACE
Argument
WORKSPACE
Option
--jsonMachine-readable output: exactly what the API answers.

Calls DELETE /v1/admin/workspaces/{workspace}/archived. Only server admins can run it.

fontego admin workspaces delete

Delete an archived workspace for good, files and history.

fontego admin workspaces delete WORKSPACE [--confirm WORKSPACE]
Argument
WORKSPACE
Option
--confirm WORKSPACEIts id again: this can't be undone.
--jsonMachine-readable output: exactly what the API answers.

Calls DELETE /v1/admin/workspaces/{workspace}. Only server admins can run it.

fontego admin audit

Who did what: the access log, newest first.

fontego admin audit [--user EMAIL] [--workspace WORKSPACE] [--since DATE] [--limit N]
Option
--user EMAILOnly this person's.
--workspace WORKSPACEOnly in this workspace.
--since DATEFrom this moment on (2026-11-17, or with the time).
--limit NHow many (default 50). Default: 50.
--jsonMachine-readable output: exactly what the API answers.

Calls GET /v1/admin/audit. Only server admins can run it.

fontego admin audit changes

Who wrote each commit, newest first.

fontego admin audit changes [--user EMAIL] [--workspace WORKSPACE] [--limit N]
Option
--user EMAILOnly this person's.
--workspace WORKSPACEOnly in this workspace.
--limit NHow many (default 50). Default: 50.
--jsonMachine-readable output: exactly what the API answers.

Calls GET /v1/admin/audit/changes. Only server admins can run it.

On this page

This machinefontego loginfontego logoutfontego sessionsfontego sessions renamefontego sessions forgetfontego usefontego openfontego helpfontego setupfontego versionSynced foldersfontego clonefontego linkfontego statusfontego check-ignorefontego syncfontego watchfontego conflictsExplorefontego workspacesfontego workspace infofontego membersfontego lsfontego catfontego logfontego searchWritefontego writefontego rmfontego mvWorkspacesfontego workspace createfontego workspace templatesfontego workspace editfontego members setfontego members removefontego workspace pathsfontego workspace paths protectfontego workspace paths unprotectfontego workspace paths rejectfontego workspace paths unrejectfontego workspace paths resetAccountfontego whoamifontego password-resetServer adminfontego admin usersfontego admin users invitefontego admin users resendfontego admin users disablefontego admin users enablefontego admin users addfontego admin tokens createfontego admin mailfontego admin mail outboxfontego admin mail testfontego admin settingsfontego admin settings getfontego admin settings setfontego admin settings resetfontego admin users removefontego admin users grant-adminfontego admin users revoke-adminfontego admin users reset-passwordfontego admin sessionsfontego admin sessions closefontego admin tokensfontego admin tokens revokefontego admin workspacesfontego admin workspaces archivefontego admin workspaces unarchivefontego admin workspaces deletefontego admin auditfontego admin audit changes