Slash commands

Type / at the start of the input box to run a command. The commands it can become are listed above the box as you type: built-in, custom, extension, and skill:<name>, each with its description. ↑ ↓ move, tab takes the marked command, enter takes it and runs it, esc closes the list. With the list closed, tab completes what the matches share and lists them in the footer. /help lists the built-in, custom and extension commands.

A message that looks like a command but is not one, such as /modles, is not sent. The footer says Unknown command /modles · did you mean /models? and the text stays in the box to fix. A path such as /usr/bin/env is missing goes to the model as a message, and so does a mistyped command with a space before it.

While Circle is working

Most commands wait until the turn ends and answer Busy · wait for the current turn to finish. These work at any time:

/help, /hotkeys, /exit, /yolo, /mode, /settings, /approvals, /jobs, /terminals, /session, /name, /tree, /themes, /thinking, /details, /agents, /copy, /export, /share, /unshare, /logout, /mcp (listing only), /skill and /extensions (listing only: /skill <name> and /extensions reload wait)

Going back with /tree while a turn runs stops the turn first. A custom command also works: its text is queued like any message.

Session

Command	Aliases	What it does
/new	/clear	Start a new session.
/resume [n\|id]	/sessions	Choose a session from a list, or open one by its number in that list or the end of its id. The list can show every folder’s sessions, rename and delete; it asks for the new name, and before deleting, on its own line.
/continue		Switch back to the previous session. With none remembered and this session still empty, open the latest saved session in this folder.
/name [title]	/rename	Set the session title, or show it.
/session		Show the session id and title, the folder, the model, where it is kept, how many messages, and the tokens used in this run.
/tree [words]		List every message of the session, all branches, and go back to one. The next message starts a branch from there. L labels a message, asking for the label in the list; esc there leaves the label as it was. esc twice on an empty input box does the same as /tree.
/fork [words]		Choose one of your messages; a new session starts with everything before it, and the message comes back to the input box.
/clone		Start a new session with the current branch of this one.
/undo		Undo the last turn on screen.
/redo		Bring it back.
/rewind		List the turns whose file changes Circle recorded and put one back, asking first: enter asks, esc at the question changes nothing. Commands and other writers are outside the journal. See Rewind a turn’s files.
/compact [hint]	/summarize	Summarize older messages now.
/jobs [id]	/tasks	List the session’s background jobs, running ones first, or open one’s page. enter opens a job’s page: a band with its lamp, id and command, state and time, and the file its output goes to, then the end of the output. ctrl+k stops a running job (after asking in the list) or removes one that has ended.
/terminals [id]		List this conversation’s device terminals, live ones first then the saved profiles, or open one console’s page. enter opens a terminal’s page or connects a profile; ctrl+d cuts a live console after asking. On the page enter attaches and esc leaves.
/agents [name]	/subagents	List the subagents task may choose: the two that ship with Circle, the markdown files in the agent folders and what extensions register. With a name it shows that one. A definition that could not be used is listed with its reason.

What these do and do not do is on Sessions. Several have limits in this version.

Output

Command	What it does
/copy	Copy the last answer to the clipboard. The footer says Copied N chars. Without a clipboard tool, it is written to exports/last-copy.txt in the data folder and the footer says Saved to file.
/export [html\|jsonl\|path]	Write the conversation as Markdown (the default, as the screen shows it), HTML or JSONL; a file name’s ending picks the format. Without a path the file goes to exports/ in the data folder.
/import <path>	Start a new session from an exported file. A JSONL export comes back exactly; any other text file is shown, and its first 8,000 characters are given to the model.
/share	Write a Markdown copy under shares/ in the data folder and copy its path. Nothing is uploaded.
/unshare	Delete that copy.
/editor	Edit the draft in $VISUAL or $EDITOR, which may include arguments such as code -w; without either, nvim, vim or nano (notepad on Windows). The result is put back in the input box, not sent. ctrl+g does the same.
/thinking [level]	Hide or show the model’s thinking rows. With a level, the same as /effort <level>.
/effort [level]	Choose how hard the model thinks from a list, or set it: minimal, low, medium, high, xhigh, max. Applies for the rest of this run; alt+d in the list also saves it. See Choose a model.
/details	Expand or collapse tool output, the same as ctrl+o.

Safety and mode

Command	Aliases	What it does
/plan [on\|off]	/plan-mode	Turn read-only mode on or off. With no argument it switches.
/yolo [off]	/auto	Stop asking before commands and file changes in this session. /yolo off asks again. Anything else, including no argument, turns it on.
/mode [manual\|accept-edits\|plan\|auto]		Set how this session asks. With no argument it moves to the next mode, as shift+tab does. accept edits changes files inside the workspace without asking. See Modes.
/bridge [start\|stop\|token]		Open or close the localhost editor bridge and show its address and token. start listens on 127.0.0.1 on a free port with a fresh token, and writes <data>/bridge.json where an editor can find both; stop closes it and removes that file. The model reads the editor only with editor_bridge on in your settings. See Security.
/approvals [allow P\|deny P\|project deny P\|forget N\|add P\|remove P\|revoke N]		List the rules of every layer - your own file, this project’s, this conversation’s - and the command patterns from settings, with the last decisions under the title; enter on a row, or its number, forgets, revokes or removes it. The list has no search: k j move, and other keys go to the input box. deny <pattern> and allow <pattern> write a rule of your own; project deny <pattern> writes the repository’s, which can only deny; forget N takes the Nth rule of the list away; revoke N removes session rule N directly; add <pattern> saves a command pattern in your settings and remove <pattern|N> takes it back. A bare pattern is a rule for execute: write tool <name> <pattern> for another. See Security.
/trust		Trust this folder. It is saved in your settings; nothing is written into the folder. The full-screen interface asks before it opens a folder you have not trusted, so there it only confirms.

See Security.

Model and account

Command	Aliases	What it does
/models [name]	/model	Choose a model from what the endpoint offers, or use one by its id, for this session. The footer says model set to … for a few seconds, and the same line stays in the transcript. It includes not listed by this endpoint when the list can be read and does not contain that id. The list marks the session’s model with ● and current. alt+d in the list also saves it as the default. alt+l opens the list; alt+m switches to the next model.
/login	/connect	Change the endpoint, key and model. It asks on its list’s own line for the base URL, filled in with the saved one, then the key, shown as dots (an empty enter keeps the saved key while the URL stays on the saved host; another host needs its key); esc on the key goes back to the URL, and esc on the URL leaves. Then it lists the endpoint’s models to search; enter on a search nothing matches uses what you typed. The session switches to them and they are saved, with the URL that answered; nothing is saved before a model is chosen.
/logout		Clear the saved credentials and mark Circle as not set up.
/settings		A list of the settings: theme, whether thinking and routine hook allow notices are shown, what esc esc opens, and the model, thinking depth, default mode, endpoint, trusted folders, MCP servers and data folder. enter changes the marked one and saves it at once; the model, depth and MCP rows open /models, /effort and /mcp, the default mode row opens the mode list (enter for this session, alt+d also saves default_mode), and the endpoint row opens /login.
/variables [NAME=value]		NAME=value sets a named value and NAME= removes it. Circle fills that name in when a tool runs. The model still writes %NAME% in the arguments; on Windows the command says so, and elsewhere it does not. Without an argument, a list of the variables and secrets; enter puts a row’s command in the input box.
/secrets [NAME]		A secret: a variable whose value the model never sees. /secrets NAME asks for the value on a masked card and keeps it in secrets.json; NAME= removes it. A value typed after = is refused. See Secrets by name.
/themes [auto\|dark\|light]		Show or set the theme. It applies at once and is saved. auto follows your terminal live; dark or light overrides it.

See Choose a model.

Extend

Command	Aliases	What it does
/memory [add [account] <note>\|remove N]		List the dated lines Circle keeps in MEMORY.md, the workspace’s first and the data folder’s after, and write or take back one. add writes in the workspace and add account in the data folder; a line about an untrusted folder waits for /trust. Only the lines Circle wrote are listed and removable. The list answers while a turn runs; a write waits for it to finish. See Configuration.
/knowledge [list\|search <text>\|read N\|import <file>\|history\|conflicts\|resolve N candidate]		Browse local knowledge, import an explicitly selected workspace UTF-8 file (at most 1 MiB), inspect immutable history or resolve a conflict by creating an approved revision covering every head. edit N <statement>, rename N <name>, move N directory and delete N also require person confirmation.
/knowledge [connect [name]\|disconnect\|status\|sync\|login\|mode synced\|mode local]		Select one existing HTTP MCP connection to a server that implements knowledge-sync v1, with person approval. Reuse its authorization for background sync; no connection is probed before selection. status says where sync stands, the next step and the server’s own reason for a refusal (refused: …), and that the server has no discovery document when it has none. login explicitly reauthorizes MCP; select the account again afterward. Mode changes show a fresh impact preview and ask the person. Local copies remain when remote personal copies are cleared; a server that asks for confirmation shows the console address to confirm the purge at. A list longer than 100 says showing 100 of N.
/memory [team\|personal\|loaded\|refresh]		Inspect frozen team preferences, browse local personal preferences, display the actual bounded session context or explicitly reload while idle. New sessions load team, personal, then files; background sync never swaps preferences mid-session.
/memory [write <title> \| <text>\|edit N <text>\|enable N\|disable N\|delete N]		Manage structured personal preferences with person approval, including in auto mode. These are separate from the original MEMORY.md commands and are never imported automatically.
/skill [name] [args]	/skills	List skills, or load one into the conversation for your next message. /skill:name also works.
/mcp [reload]		List MCP servers and tools, or reconnect them.
/extensions [reload]	/ext	List extensions, or reload them.
/reload		Re-read settings.json (yours and the project’s), hooks.json and keybindings.json, reconnect MCP servers, reload extensions and rebuild the agent. session_start hooks are not run again.
/init [focus]		Ask Circle to write AGENTS.md for the project.

Help and exit

Command	Aliases	What it does
/help		List commands.
/hotkeys		Show the keyboard shortcuts. ? on an empty prompt does the same.
/exit	/quit, /q	Quit.

Line mode

Line mode understands only /help and /exit (and /quit, /q). Other commands are not sent to the model; standard error says so. See CLI.

Name clashes

A custom command replaces a built-in command of the same name, except /help, /hotkeys and /exit. An extension command cannot take the name of a built-in or a custom command. See Custom commands.