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 | |
|---|---|
TARGET | An alias you already have, or the address of a Fontego. Optional. |
| Option | |
|---|---|
--device | Show a code to type in a browser on another device (no browser here). |
--token TOKEN | Sign in with a token instead, for scripts and CI (or set FONTEGO_TOKEN). |
--alias ALIAS | The short name to use for this Fontego (default: from its name). |
--json | Machine-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 | |
|---|---|
ALIAS | Optional. |
| Option | |
|---|---|
--all | Every Fontego of this machine. |
--json | Machine-readable output. |
fontego sessions
The Fontegos of this machine: account, whether signed in, and when each session ends.
fontego sessions| Option | |
|---|---|
--json | Machine-readable output. |
fontego sessions rename
Give a Fontego another alias.
fontego sessions rename ALIAS NEW| Argument | |
|---|---|
ALIAS | |
NEW |
| Option | |
|---|---|
--json | Machine-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 | |
|---|---|
--json | Machine-readable output. |
fontego use
Choose the Fontego commands go to by default.
fontego use ALIAS| Argument | |
|---|---|
ALIAS |
| Option | |
|---|---|
--json | Machine-readable output. |
fontego open
Open the web app, already signed in.
fontego open [WORKSPACE] [--print]| Argument | |
|---|---|
WORKSPACE | Optional. |
| Option | |
|---|---|
--print | Only show the link (it works once, for two minutes). |
--json | Machine-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 | |
|---|---|
COMMAND | Optional. |
| Option | |
|---|---|
--agent | Markdown for an AI agent. |
--json | Machine-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 | |
|---|---|
--remove | Take the skill away again. |
--print | Print the skill (SKILL.md) instead, to put it somewhere else. |
--json | Machine-readable output. |
fontego version
The version of this CLI.
fontego version| Option | |
|---|---|
--json | Machine-readable output. |
Synced folders
fontego clone
Make DIR (default ./WORKSPACE) a synced copy of the workspace.
fontego clone WORKSPACE [DIR]| Argument | |
|---|---|
WORKSPACE | |
DIR | Optional. |
| Option | |
|---|---|
--json | Machine-readable output. |
fontego link
Connect a folder that already has files (default: this one) and send them up.
fontego link WORKSPACE [DIR]| Argument | |
|---|---|
WORKSPACE | |
DIR | Optional. |
| Option | |
|---|---|
--json | Machine-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 | |
|---|---|
DIR | Optional. |
| Option | |
|---|---|
--ignored | List what the ignore rules keep here (--json always does). |
--json | Machine-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 | |
|---|---|
PATH | A file or folder inside a synced folder. |
| Option | |
|---|---|
--json | Machine-readable output. |
fontego sync
Sync once: bring down, send up.
fontego sync [DIR]| Argument | |
|---|---|
DIR | Optional. |
| Option | |
|---|---|
--json | Machine-readable output. |
fontego watch
Keep syncing: seconds after you edit, and when others commit; waits while offline.
fontego watch [DIR]| Argument | |
|---|---|
DIR | Optional. |
| Option | |
|---|---|
--json | Machine-readable output. |
fontego conflicts
Conflict copies waiting to be merged by hand (works offline).
fontego conflicts [DIR]| Argument | |
|---|---|
DIR | Optional. |
| Option | |
|---|---|
--json | Machine-readable output. |
Explore
fontego workspaces
The workspaces you can see, with your role.
fontego workspaces [--category CATEGORY]| Option | |
|---|---|
--category CATEGORY | Only this category. |
--json | Machine-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 WORKSPACEAlso: fontego info.
| Argument | |
|---|---|
WORKSPACE |
| Option | |
|---|---|
--json | Machine-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 | |
|---|---|
--json | Machine-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 | |
PATH | Folder to list (default: the top). Optional. |
| Option | |
|---|---|
-r, --recursive | Every file below the folder. |
--rev REV | As it was at this commit. |
--json | Machine-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 REV | As it was at this commit. |
--json | Machine-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 | |
PATH | Only changes to this file or folder. Optional. |
| Option | |
|---|---|
--limit N | How many commits (default 20). Default: 20. |
--json | Machine-readable output: exactly what the API answers. |
Calls GET /v1/workspaces/{workspace}/history.
fontego search
Find text in the workspace's files.
fontego search WORKSPACE TEXT [--path FOLDER] [--limit N]| Argument | |
|---|---|
WORKSPACE | |
TEXT |
| Option | |
|---|---|
--path FOLDER | Only inside this folder. |
--limit N | At most this many lines (default 100). |
--json | Machine-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 | |
CONTENT | The whole new content. Left out, it is read from stdin. |
| Option | |
|---|---|
--base HASH | Hash of the version you edit (fontego cat WORKSPACE PATH --json); left out, only a new file is written. |
-m, --message TEXT | What changed (the commit message). |
--json | Machine-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 HASH | Hash of the version you start from (fontego cat WORKSPACE PATH --json). |
-m, --message TEXT | What changed (the commit message). |
--json | Machine-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 HASH | Hash of the version you start from (fontego cat WORKSPACE PATH --json). |
-m, --message TEXT | What changed (the commit message). |
--json | Machine-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 | |
|---|---|
WORKSPACE | Its id: lowercase letters, digits and dashes. |
| Option | |
|---|---|
--name NAME | Name people see. |
--description TEXT | What it is for. |
--category CATEGORY | Category it is listed under. |
--template NAME | Start from a template (fontego workspace templates). |
--git URL | Import a Git repository this server can reach (https), with its history. |
--branch BRANCH | With --git: the branch to import (default: the repository's own). |
--no-history | With --git: only its last version, as one commit. |
--json | Machine-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 | |
|---|---|
--json | Machine-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 NAME | Name people see. |
--description TEXT | What it is for. |
--category CATEGORY | Category it is listed under. |
--json | Machine-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 | |
ROLE | reader, editor or admin. |
| Option | |
|---|---|
--json | Machine-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 | |
|---|---|
--json | Machine-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 | |
|---|---|
--json | Machine-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 | |
PATTERN | Like /AGENTS.md (any folder) or .claude/ (everything under it); quote it. |
| Option | |
|---|---|
--json | Machine-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 | |
PATTERN | Like /AGENTS.md (any folder) or .claude/ (everything under it); quote it. |
| Option | |
|---|---|
--json | Machine-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 | |
PATTERN | Like /AGENTS.md (any folder) or .claude/ (everything under it); quote it. |
| Option | |
|---|---|
--json | Machine-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 | |
PATTERN | Like /AGENTS.md (any folder) or .claude/ (everything under it); quote it. |
| Option | |
|---|---|
--json | Machine-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 KIND | Only protected, or only rejected. |
--json | Machine-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 | |
|---|---|
--json | Machine-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 | |
|---|---|
--json | Machine-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 | |
|---|---|
--json | Machine-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 NAME | Their name, as others will see it. |
--admin | Make them a server admin. |
--json | Machine-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 | |
|---|---|
--json | Machine-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 | |
|---|---|
--json | Machine-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 | |
|---|---|
--json | Machine-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 NAME | Their name, as others will see it. |
--admin | Make them a server admin. |
--json | Machine-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 LABEL | What it's for: a machine, an agent. |
--agent | A token for their agent, so the log tells them apart. |
--json | Machine-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 | |
|---|---|
--json | Machine-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 | |
|---|---|
--json | Machine-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 | |
|---|---|
--json | Machine-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 | |
|---|---|
--json | Machine-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 | |
|---|---|
KEY | From fontego admin settings: displayName, smtp.host... |
| Option | |
|---|---|
--json | Machine-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 | |
|---|---|
KEY | From fontego admin settings: displayName, smtp.host... |
VALUE | The new value. Left out, it is asked for without showing what you type. |
| Option | |
|---|---|
--json | Machine-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 | |
|---|---|
KEY | From fontego admin settings: displayName, smtp.host... |
| Option | |
|---|---|
--json | Machine-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 | |
|---|---|
--yes | Yes, delete it: this can't be undone. |
--json | Machine-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 | |
|---|---|
--json | Machine-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 | |
|---|---|
--json | Machine-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 | |
|---|---|
--json | Machine-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 EMAIL | Only this person's. |
--json | Machine-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 | |
|---|---|
ID | From fontego admin sessions. |
| Option | |
|---|---|
--json | Machine-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 EMAIL | Only this person's. |
--json | Machine-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 | |
|---|---|
ID | From fontego admin tokens. |
| Option | |
|---|---|
--json | Machine-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 | |
|---|---|
--json | Machine-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 | |
|---|---|
--json | Machine-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 | |
|---|---|
--json | Machine-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 WORKSPACE | Its id again: this can't be undone. |
--json | Machine-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 EMAIL | Only this person's. |
--workspace WORKSPACE | Only in this workspace. |
--since DATE | From this moment on (2026-11-17, or with the time). |
--limit N | How many (default 50). Default: 50. |
--json | Machine-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 EMAIL | Only this person's. |
--workspace WORKSPACE | Only in this workspace. |
--limit N | How many (default 50). Default: 50. |
--json | Machine-readable output: exactly what the API answers. |
Calls GET /v1/admin/audit/changes. Only server admins can run it.