Skip to main content
Craft Agents supports slash commands for quick actions. Type / to see available commands, or use /help for a full list.

General Commands

/help

Show all available commands and their descriptions.
> /help

/clear

Clear the current conversation history and start fresh.
> /clear
This doesn’t affect your Craft documents - only the conversation memory.

/new

Start a fresh conversation while keeping your chat history.
> /new
This creates a new conversation thread, unlike /clear which removes history entirely.

/resume

Continue a previous conversation from your history.
> /resume
Opens an interactive menu to select and resume from past conversations.

/context

See how much of the conversation memory is being used.
> /context
Shows current token usage and available context window capacity:
Context Usage
⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁  Cache read: 105.9k (sys prompt, tools, history)
⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁  Cache write: 812 (new additions to cache)
⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁  Uncached: 1
⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛶  Free: 48.3k (24%)
⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛁ ⛝  Buffer: 45.0k (23%)
⛁ ⛁ ⛁ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ →  Output: 1 (added next turn)
⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶
⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛶ ⛝ ⛝ ⛝
⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝
⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝ ⛝
claude-opus-4-5-20251101 · 107k/200k tokens (53%)

/exit

Exit Craft Agents.
> /exit
You can also press Ctrl+C or Ctrl+D to exit.

Agent Commands

/agent list

Show all available sub-agents in your workspace.
> /agent list
Available agents:
  • research
  • writer
  • work/code-review
  • work/sprint-planning

/agent activate

Activate a sub-agent by name. You can also use the @ shorthand.
> /agent activate research
Equivalent to:
> @research

/agent clear

Return to the main assistant, deactivating any active sub-agent.
> /agent clear
Equivalent to:
> @main

/agent reload

Reload the current agent’s instructions from its Craft document. Use this after editing the agent document.
> /agent reload

/agent refresh

Rescan the Agents folder for new or removed agents.
> /agent refresh

/agent info

Show details about the currently active agent.
> /agent info

Workspace Commands

/workspace

Show the current workspace and available workspaces.
> /workspace
Current: Personal Notes
Available:
  • Personal Notes (active)
  • Work Projects

/workspace add

Add a new workspace connection.
> /workspace add
This starts an interactive prompt to configure the new workspace.

/workspace rename

Rename the current workspace.
> /workspace rename
New name: My Personal Space

/workspace remove

Remove a workspace from your configuration.
> /workspace remove
This removes the workspace from Craft Agents, but doesn’t affect your actual Craft workspace.

Model Commands

/model

Change the AI model. Opens a selection menu.
> /model
Select model:
  • claude-sonnet-4 (current)
  • claude-opus-4
  • claude-haiku-4
Or specify directly:
> /model opus
> /model sonnet
> /model haiku

Plan Mode Commands

Plan Mode provides a structured workflow for complex tasks. See Plan Mode for a complete guide.

/plan

Open the Plan Mode menu with options to start, view plans, approve, or cancel.
> /plan

/plan start

Enter Plan Mode. The agent will gather requirements and create a plan before executing.
> /plan start
You can also press Shift+Tab to toggle Plan Mode.

/plan plans

View, load, or delete saved plans.
> /plan plans
Use arrow keys to navigate, Enter to load, Space to select for deletion, and D to delete selected.

/plan view

View the current plan details.
> /plan view

/plan approve

Approve and execute the current plan.
> /plan approve

/plan cancel

Exit Plan Mode without executing.
> /plan cancel

Settings Commands

/settings

Open the settings menu for configuration options.
> /settings

/safemode

Toggle Safe Mode to protect your documents. When enabled, you’ll be asked to confirm before any document changes.
> /safemode
You can also use Ctrl+S to toggle Safe Mode quickly. See Safe Mode for details.

/prefs

Edit your user preferences (name, timezone, location, language).
> /prefs
These preferences are included in the system prompt so the agent can personalize responses.

Tools and Debugging

/tools

List all available MCP tools.
> /tools
For detailed information about each tool:
> /tools -v

/debug

Show debug information including file paths and configuration.
> /debug
Config: ~/.craft-agent/config.json
Credentials: ~/.craft-agent/credentials.enc
Debug log: /tmp/craft-debug.log

Billing and Credits

/credits

View your current billing method and credit balance.
> /credits

/balance

Open the Craft AI Credits top-up page in your browser.
> /balance

Other Commands

/paste

Paste content from your clipboard (files or images).
> /paste

/logout

Clear all settings and credentials. This resets Craft Agents to its initial state.
> /logout
This removes all stored credentials and workspace configurations. You’ll need to run setup again.

/feedback

Send feedback with your session transcript attached.
> /feedback
Opens your email client with a pre-filled message.

Command Summary

CommandDescription
/helpShow all commands
/clearClear conversation
/newStart fresh conversation
/resumeContinue previous conversation
/contextShow memory usage
/exitExit application
/agent listList sub-agents
/agent activate <name>Activate sub-agent
/agent clearReturn to main agent
/agent reloadReload agent instructions
/agent refreshRescan agents folder
/agent infoShow active agent info
/workspaceShow workspaces
/workspace addAdd workspace
/workspace renameRename workspace
/workspace removeRemove workspace
/modelChange AI model
/planOpen Plan Mode menu
/plan startEnter Plan Mode
/plan plansView/load/delete plans
/plan viewView current plan
/plan approveApprove and execute plan
/plan cancelExit Plan Mode
/settingsOpen settings
/safemodeToggle document protection
/prefsEdit preferences
/toolsList MCP tools
/tools -vList tools with details
/debugShow debug info
/creditsView billing info
/balanceTop up credits
/pastePaste from clipboard
/logoutClear all settings
/feedbackSend feedback