The CLI
Install fontego, sign in to one or several Fontegos, and find your way around its commands.
fontego is how people, agents and scripts use a Fontego from a terminal: sign in, explore workspaces, keep folders in
sync, write single files and run the instance. It can do anything the web app can.
Install
There are no packaged releases of fontego yet: it isn't on npm and has no install script. Until the first one, run
it from its repository, with Bun 1.3.14 or newer:
git clone https://github.com/fontego-ai/fontego-cli.git
cd fontego-cli && bun install
alias fontego="bun $PWD/cli/src/main.ts"Then teach the AI agents on your machine to use it, with fontego setup (see Agents).
Sign in
fontego login https://fontego.example.orgIt opens the browser, where you sign in and authorize this machine, and waits. On a machine without a browser it shows
a code to type on any other device instead (or ask for that with --device). For scripts and CI, --token TOKEN
signs in with a token an admin gave you.
Sessions last as long as the instance says (by default they end after 30 days unused, or at 90 days), and renew by
themselves while you use them. fontego logout closes the session on the server too.
Several Fontegos
One machine can be signed in to several instances, each under a short alias:
fontego sessions # each Fontego of this machine, its account and when its session ends
fontego use work # the one commands go to by default
fontego workspaces --instance home
fontego sessions rename fontego-example workA command goes to the instance named by --instance, else FONTEGO_INSTANCE, else the instance of the synced folder
it runs in, else the default. FONTEGO_URL with FONTEGO_TOKEN overrides all of that with a server and a token,
without saving anything.
The list of instances ($XDG_CONFIG_HOME/fontego/config.json) holds no secrets. Credentials go to the system's
keychain, or to credentials.json (mode 0600) where there is none.
Commands
fontego help # every command you can run on this Fontego
fontego help sync # one command: its arguments, options and the call it makes
fontego help --agent # a guide for agents, in MarkdownSome commands are built into the CLI: signing in, and everything about synced folders. The rest come from the server:
each instance publishes its commands, and the CLI learns them when it signs in and whenever they change. So
fontego help always shows what your Fontego can do, and admin commands appear only for server admins.
Every command accepts --json. For commands that come from the server, it prints exactly what the API answered.
fontego open [WORKSPACE] opens the web app in the browser, already signed in.
Every command, with all its options: CLI reference.