Slash commands

Type / in fx to browse commands. For commands you run from your terminal, see CLI commands.

Type after the / to filter the menu. It matches a command or alias in any letter case, by each word, and by its letters in order, so /mdl finds /model. Exact names come first, then names that start with what you typed, then other matches. After a command and a space, the menu suggests its arguments where it knows them, such as auto after /permissions or a server name after /mcp show. In /help, typing also matches each command's description and category.

Sessions and shell

CommandDescription
/helpShow interactive help.
/clear / /newStart a fresh conversation and keep background processes running.
/resetStart a fresh conversation and stop workspace background processes.
/resumeOpen the saved-session picker.
/forkStart a new conversation from before a chosen prompt, with that prompt in the composer to edit. See Fork a conversation.
/rename <title>Rename the current conversation.
/launch [profile]Start another fx instance, optionally in an agent profile, and show it.
/closeClose the instance on screen. Closing the last one exits fx.
/agentsList the open agents and switch to one.
/compactSummarize older conversation context.
/shell reloadReload shell startup configuration and clear remembered command approvals.
/quitExit fx. /exit is an alias.

See Sessions for saving, recovery, and compaction.

Account, model, and runtime

CommandDescription
/providerChoose a provider and how to connect to it. /setup still opens it with a warning until fx 0.0.18.
/loginOpen the provider picker to sign in.
/logout [vercel|codex|grok]Sign out of the active or named provider.
/model [id-or-query]Choose a model and reasoning effort, or pass a model ID or search term.
/effort [level]Choose the reasoning effort for the current model, or pass a level such as high.
/fast [on|off]Toggle Fast mode, or turn it on or off. Turning it on needs a model that supports it.
/ultrafast [on|off|status]Enable, disable, or inspect the higher-priced Ultrafast request. With no argument, show status without changing it.
/permissions [ask|auto|full-access|reset]Show the permission mode, rules, and session grants in a panel, or change the mode. reset switches back to ask and clears the session grants.
/allowlistInspect or change persistent permission rules.

Use /permissions full-access to disable fx permission checks. /permissions full access and the legacy /permissions yolo are also accepted. See Permissions for permission rules and modes.

Saved permission rules

Save an exact allow or deny rule for the current saved conversation, or remove one by ID:

/permissions remember allow|deny <tool> <arguments-json>
/permissions revoke <rule-id>

Both commands ask for confirmation. The /permissions panel lists saved rules and their IDs. See Saved conversation rules for an example.

Persistent permission rules

/allowlist alone lists the allow rules in effect from ~/.fx/settings.json. These forms view or change them:

/allowlist view [effective|workspace|global]
/allowlist [workspace|global] add command|tool|url|web-fetch-domain <pattern>
/allowlist [workspace|global] remove command|tool|url|web-fetch-domain <pattern>
/allowlist [workspace|global] reset commands|tools|urls|web-fetch-domains|all

add saves an allow rule. Changes apply to the current workspace unless you name global. Quote a pattern that contains spaces, as in /allowlist global add command "git status". The older scope words local and user still work with a warning until fx 0.0.18. See Persistent rules for how rules match.

Inspection and settings

CommandDescription
/statusShow the session ID, model, workspace, and permissions in a panel.
/statsShow terminal rendering counters for this fx process: bytes of terminal output, redraws, debounced resizes, footer updates, and stream chunks. For usage and spend, use /usage.
/usageShow your provider's usage and spend: AI Gateway reports, or your Codex or Grok plan usage.
/creditsShow the AI Gateway credit balance. /balance is an alias.
/settings [startup-scrollback [on|off]]Open settings. With startup-scrollback, turn the startup_scrollback setting on or off, or toggle it.
/statusline [context|session|workspace]Choose which fields appear in the footer, or toggle the one you name.
/sound [on|off|max]Turn sounds and terminal bells on or off, or toggle them with no argument. max adds interaction sounds.
/versionShow the installed version.

Tools and local data

CommandDescription
/image <path>Attach an image. /img is an alias.
/images [clear]List pending images, or remove them with clear.
/pasteAttach a clipboard image when supported.
/mcp [command]Connect and manage MCP servers. See Interactive MCP commands.
/skills [command]Browse and manage skills with show, install, create, remove, and path. add is an alias of install.
/workspace [list|add <path>|remove <path>|clear]Manage saved additional directories. With no argument, open them in a list.
/undoUndo the most recent tracked file operation.
/copyCopy the latest assistant response.
/feedbackOpen the fx feedback form.
/traceCreate and copy a private diagnostic trace.

See Additional workspaces for directory access and Share feedback for diagnostics.

Undo tracked file changes

Repeat /undo to undo earlier changes made by fx’s file tools. Shell commands and edits made outside those tools are not tracked.

Interactive MCP commands

Use these inside fx. They take the same arguments as fx mcp and print the same text. For setup and examples, see MCP.

/mcp
/mcp list
/mcp show <name>
/mcp add [--global | --project] [--no-login] [--header KEY=VALUE]... <name> <url>
/mcp add [--global | --project] [--env KEY=VALUE]... <name> -- <command> [args...]
/mcp add [--global | --project] [--no-login] slack
/mcp remove [--global | --project] <name>
/mcp login [--no-browser] <name>
/mcp logout <name>
/mcp approve <name>
/mcp approve --all
/mcp reject <name>

fx mcp call has no /mcp form, because it runs only in a command that fx's shell tool runs. /mcp alone opens the server menu; see Keyboard shortcuts for its keys. /mcp add signs in to a remote server that needs a login unless you pass --no-login. /mcp login signs in while you keep working and says when it's done. --project writes or removes the entry in the project's .mcp.json instead of ~/.fx/mcp.json; when both files define a name, remove asks for --global or --project.