Slash Commands
This page covers every command available in Huginn’s / picker — what each one does, when to use it, and real examples.
How the picker works
Type / in the chat input to open the inline picker. It filters in real time as you keep typing — /pl narrows to /plan before you finish.
| Key | Action |
|---|---|
| Any character | Narrows the list |
Enter | Selects the highlighted command |
Tab | Autocompletes to the highlighted command |
Escape | Dismisses the picker |
Built-in commands and user-installed skills share the same list. There is no visual distinction between them.
Workflow commands
These commands control how the agent approaches your request.
/plan
Switches the active slot to the planner model (Chris by default) and primes it for structured output. Use this before writing any code.
/plan
describe a Redis cache layer for the user service
After planning, hand off to Steve with /code.
/code
Switches to the coder model (Steve by default). No planning phase — sends your request straight to implementation.
/code fix the nil pointer dereference in auth.go:47
/reason
Switches to the reasoner model (Mark by default). Slower, more thorough. Use it when you need careful analysis before acting.
/reason should I use a message queue or direct HTTP calls here?
/iterate [N]
Runs the agent multiple times on the same task. Each pass receives the output of the previous one as context. Prompts for N if you don’t supply it.
/iterate 3
Good for code quality, prose polish, or test generation where one pass isn’t enough.
/parallel <task1> | <task2> | ...
Runs multiple tasks at the same time using the default agent. Separate tasks with |. Results appear sequentially, labeled by number, when all complete.
/parallel Write unit tests for auth.go | Write unit tests for session.go | Write unit tests for relay.go
All tasks run concurrently. Use this when they don’t depend on each other.
/swarm <agent>:<prompt> | <agent>:<prompt> | ...
Like /parallel, but you route each task to a specific named agent. Agents run concurrently and stream results into the swarm view.
/swarm Steve:implement the login handler | Mark:review the auth logic for edge cases
Each segment is agentName:prompt. Without a colon, the whole segment is treated as both the agent name and the prompt. Use /swarm with no arguments to re-open the swarm view if you’ve navigated away.
/parallelvs/swarm:/parallelsends all tasks to the default agent./swarmroutes each task to a specific named agent.
Agent & model commands
/agents
With no arguments, shows the agent roster and opens the agents management screen.
Sub-commands:
| Sub-command | Syntax | What it does |
|---|---|---|
| (none) | /agents | Show roster, open agents screen |
new | /agents new | Open the agent creation wizard |
create | /agents create <name> <model> | Create an agent non-interactively |
swap | /agents swap <name> <model> | Switch an agent’s model and persist the change |
rename | /agents rename <name> <new-name> | Rename an agent |
persona | /agents persona <name> | Display an agent’s system prompt |
delete | /agents delete <name> | Permanently delete an agent |
/agents create Petra claude-opus-4-6
/agents swap Steve claude-sonnet-4-6
/agents rename Chris Architect
/agents persona Mark
/agents delete Petra
Changes are written to ~/.huginn/agents/ immediately and take effect in the current session.
/switch-model
Opens an interactive prompt to change the model for the current session slot without saving it to your config. Takes free-form input.
/switch-model
use claude-opus-4-6 for planning
Use this for a one-off override without touching your saved configuration.
/dm [agent-name]
Opens or creates a Direct Message space with a specific agent. DM spaces are persistent and separate from main chat sessions.
/dm Steve
/channel [name]
Opens or creates a Channel space for multi-agent collaboration.
/channel backend-review
Code intelligence commands
These commands work against your indexed workspace. Run /workspace first to confirm your project is indexed.
/radar
Runs the Proactive Impact Radar against the current git repo. Compares HEAD to its parent, identifies changed files, and reports which other parts of the codebase may be affected.
/radar
Findings are grouped by severity. Requires a git repo at the workspace root with the symbol index populated.
/impact <symbol>
Runs call-graph impact analysis on a named function, type, or identifier. Reports all callers and dependents grouped into HIGH, MEDIUM, and LOW confidence tiers.
/impact validateSession
If no edges are found, Huginn suggests running /workspace to index the repo first.
/workspace
Shows the active workspace state: root path and number of indexed chunks.
/workspace
Run this before /radar or /impact to confirm Huginn has picked up the right project directory.
Session commands
/resume
Opens the session picker overlay. Select a previous session by number or name to restore the full message history.
/save
Force-saves the current session to disk right now. Huginn auto-saves periodically, but use this before closing the terminal if you want certainty.
/title <text>
Renames the current session. Session names appear in the sidebar and in the /resume picker.
/title Auth refactor — March sprint
Sessions are auto-named from your first message but can be renamed at any time.
/notepad
Manages persistent notepads that inject standing context into every agent session.
| Sub-command | Syntax | What it does |
|---|---|---|
list | /notepad list | List all notepads |
show | /notepad show <name> | Display a notepad’s full content |
create | /notepad create <name> | Create a new notepad |
delete | /notepad delete <name> | Delete a notepad permanently |
With no sub-command, the usage summary is shown.
Debug & info commands
/stats
Displays live session statistics: tokens used (input and output), estimated cost, model latency (median and p95), cache hit rate, and files indexed.
/help
Shows the keybindings reference and a summary of slash commands in the current terminal session.
TUI keybindings (also shown by /help):
| Key | Action |
|---|---|
Shift+Tab | Toggle auto-run mode on/off |
ctrl+c | Cancel active stream / clear input |
ctrl+d | Exit Huginn |
ctrl+b | Toggle sidebar focus |
ctrl+p | Cycle to next primary agent |
ctrl+a | Open agent creation wizard |
G | Jump to bottom of viewport and resume follow mode |
Navigation commands
These commands navigate directly to a screen with no arguments needed.
| Command | Navigates to |
|---|---|
/models | Model management — view, pull, delete models |
/connections | Connections manager — OAuth provider setup and token status |
/skills | Skills screen — browse, install, and manage skills |
/settings | Settings — model selection, theme, backend config |
/workflows | Workflow manager — create, trigger, view run history |
/logs | Application log viewer |
/inbox | Notification inbox — workflow results and alerts |
You don’t always need a slash
Most things you’d reach for a command to do can be said directly in plain English. Huginn dispatches to the right agent and approach on its own.
have Steve review the auth module
plan a refactor of the database layer
ask Chris to design the new API endpoints
run the test suite and tell me what's failing
Use slash commands when you want explicit control — a specific model, a parallel run, a named agent. Use plain language for everything else.
Skills add commands to the picker
Any skill you install and enable automatically appears in the / picker alongside built-in commands. There is no visual distinction.
huginn skill install <skill-name>
Overriding a built-in: Create a skill with the same name as a built-in. User-installed skills always take precedence over built-ins with the same name — no flags or config required.
See Skills for the full skill system reference.
Full command reference
| Command | Group | Description |
|---|---|---|
/plan | Workflow | Switch to planner model (Chris) |
/code | Workflow | Switch to coder model (Steve) |
/reason | Workflow | Switch to reasoner model (Mark) |
/iterate [N] | Workflow | Run N refinement passes on the same task |
/parallel <tasks> | Workflow | Run tasks concurrently with the default agent |
/swarm <agent:prompt> | Workflow | Dispatch tasks to specific named agents concurrently |
/agents [sub] | Agent | List, create, rename, swap, persona, or delete agents |
/switch-model | Agent | Change the model for the current session slot |
/dm [agent] | Agent | Open or create a DM space with an agent |
/channel [name] | Agent | Open or create a Channel space |
/radar | Code intelligence | Impact scan for recent git changes |
/impact <symbol> | Code intelligence | Call-graph analysis for a symbol |
/workspace | Code intelligence | Show workspace root and index status |
/resume | Session | Open session picker to restore a previous session |
/save | Session | Force-save current session immediately |
/title <text> | Session | Rename the current session |
/notepad [sub] | Session | Manage persistent notepads |
/stats | Info | Token usage, cost, latency, cache stats |
/help | Info | Show keybindings and command reference |
/models | Navigation | Model management screen |
/connections | Navigation | Connections manager |
/skills | Navigation | Skills screen |
/settings | Navigation | Settings screen |
/workflows | Navigation | Workflow manager |
/logs | Navigation | Log viewer |
/inbox | Navigation | Notification inbox |