Slash Commands

UGENT provides a rich set of slash commands for the TUI and REPL. Type / in the input box to see autocomplete suggestions. This guide covers every built-in command, grouped by category.

Quick Reference

Type /help inside UGENT to see all available commands at any time.

Help and System

Command	Description
/help (alias /h)	Show all available commands with usage examples
/version (alias /v)	Show UGENT version information
/status	Show system status — version, session, tasks, memory, LSP, MCP, plugins, cron, skills. Use /status --full for details
/reload	Reload workspace configuration and rebuild runtime services. Picks up config file changes without restarting
/cd <path>	Switch to a different workspace directory at runtime. Requires confirmation — re-enter the command to confirm
/clear	Clear chat history in the current session
/quit (aliases /q, /exit)	Exit UGENT

Provider and Model

Command	Description
/setup	Open the setup hub. Subcommands: llm, audio, embedding, context, doctor, legacy
/providers	Manage LLM instances. list to see all, use <provider:instance> to switch, model [picker|set <name>] to change model, edit to open config
/builtin-search	Toggle provider-native built-in web search. on / off, optionally specify a provider instance
/with <provider:instance[@model]> <prompt>	Send a one-shot request using a specific LLM instance and model without changing your default

See also: LLM Providers

Live (Realtime Sessions)

The /live command opens a real-time WebSocket session for voice and text interaction. It works with providers that support bidirectional streaming.

Command	Description
/live	Open a realtime session on the default instance
/live <instance>	Open a realtime session on a specific instance
/live say <text>	Send a text turn to the active live session
/live stop	End the active live session (alias: /live end)
/live status	Show current live session state

Supported Providers and Models

Realtime models only

Only models with realtime or live in the name are accepted. Standard chat models (GPT-5.5, Claude Opus, etc.) cannot be used with /live — they lack the bidirectional streaming protocol.

Provider	Realtime Models	Audio
OpenAI	gpt-4o-realtime-preview, gpt-realtime	Full duplex (mic + speaker)
Azure OpenAI	Same, deployed as a realtime deployment	Full duplex
Google	gemini-2.5-flash-native-audio	Full duplex (BidiGenerateContent)

Configuration

Enable the Live API on an instance:

[llm.instances.openai.media.live]
enabled = true
model = "gpt-4o-realtime-preview"
input_audio = true
output_audio = true
input_video = false
realtime_transcript = true

Audio Mode

With the live-audio build feature enabled, /live captures microphone input and plays spoken replies through the speaker with barge-in support. Without it, /live runs in text mode: you type turns and read the transcript in the chat.

Usage Example

/live openai            # Open a realtime session on the openai instance
/live say hello there   # Send a text turn
/live status            # Check session state
/live stop              # End the session

See also: Google AI (Gemini) for Live API config, OpenAI for Realtime API setup.

Tools and Integration

MCP Servers

Command	Description
/mcp	List configured MCP services and their connection status
/mcp add <name> stdio <command> [args...]	Add an MCP service with stdio transport
/mcp add <name> http <url>	Add an MCP service with HTTP transport
/mcp wizard	Launch interactive MCP setup wizard
/mcp enable <name>	Enable an MCP service
/mcp disable <name>	Disable an MCP service
/mcp test [name]	Test connection to one or all MCP services

/mcp add http takes a URL and nothing else, so it cannot configure a server that needs a bearer token. For those use ugent mcp add, which accepts --header and --token-ref and works without a REPL — the headless case.

See also: MCP Servers

LSP

Command	Description
/lsp	Show LSP server status
/lsp start	Start a language server
/lsp stop	Stop LSP server
/lsp restart	Restart LSP server
/lsp detect	Detect available language servers for the workspace
/lsp auto	Toggle automatic LSP startup

Security

Command	Description
/firewall	Show injection firewall status
/firewall pins [--changed]	Show MCP pin baselines (use --changed to show only changed pins)
/firewall approve <server>	Approve an MCP server's pin
/firewall approve --all	Approve all pending MCP pins
/firewall reset	Reset all MCP pin approvals

OS Sandbox

Command	Description
/sandbox	Show effective sandbox status
/sandbox status	Effective state and per-class policy summary
/sandbox profile <class>	Resolved policy for bash, tooling, mcp_server, external_agent, or plugin
/sandbox test	Prove containment is enforced right now (distinguishes sandbox EPERM from ordinary EACCES)
/sandbox reload	Re-read sandbox.toml and rebuild
/sandbox on / /sandbox off	Toggle for this session only

The sandbox is kernel-enforced containment for every process UGENT spawns. Human-only — never exposed as an LLM tool. See also: OS Sandbox

See also: Security & Firewall

Plugins

Command	Description
/plugin	List all plugins and their status
/plugin enable <name>	Enable a plugin
/plugin disable <name>	Disable a plugin
/plugin restart <name>	Restart a plugin worker
/plugin logs	View recent plugin logs

Skills

Command	Description
/skills	List loaded MCP services and skills
/skills reload	Reload skills from disk
/<skill_name>	Execute a loaded skill by name

See also: Skills

Rules Engine

Command	Description
/rules	Show rule engine status
/rules reload	Reload rules from the rules file
/rules status	Show rule engine configuration and loaded rules
/rules test <message>	Test a message against the rule engine to see which rule matches

See also: Rule Engine

Swarm

Command	Description
/swarm	Show swarm status
/swarm init	Initialize swarm node
/swarm peers	List trusted peers
/swarm connect <url>	Connect to a peer
/swarm trust	Manage peer trust
/swarm task	Dispatch a task to a peer
/swarm context	Share context with peers
/swarm revoke	Revoke peer trust

External Agents

Command	Description
/claude	Claude Code session management
/claude exec [prompt]	Execute a Claude Code session (supports --session, --max-iterations, --yolo, --safe, --inherit, --custom)
/claude status	Show active Claude Code sessions
/claude list	List all tracked sessions
/claude instances	List Claude Code instances
/codex	OpenAI Codex session management (same subcommands as /claude, plus --full-auto)

Terminal Multiplexer

Command	Description
/herdr	Toggle Herdr terminal multiplexer integration
/herdr on	Enable Herdr integration
/herdr off	Disable Herdr integration
/herdr status	Show Herdr integration status

Memory and Context

Memory

Command	Description
/memory	Show memory system status
/memory status	Detailed memory store statistics
/memory remember <text>	Manually record a memory entry
/memory reindex	Rebuild the memory search index
/memory compact	Trigger memory compaction
/memory reembed	Re-embed all memory entries with the current embedding model
/memory feedback <helpful|not_helpful>	Provide feedback on memory recall quality
/memory open	Open the memory store directory

See also: Memory

Context Client

Command	Description
/context	Show context client status
/context status	Detailed context client status (indexed files, sync state, queue)
/context sync [--since <dur>]	Incremental sync — only changed files. --since accepts durations like 1h, 30m
/context sync --since-commit <ref>	Sync files changed since a git commit
/context force-sync [path]	Force full re-sync of all files or a specific path
/context restart	Restart the context client service
/context setup	Configure context client settings interactively
/context enable	Enable context client for this workspace
/context disable	Disable context client for this workspace

Session and Checkpoint

Command	Description
/new	Start a fresh conversation (archives the current session)
/resume	Resume a previous session. Shows a picker if no argument, or /resume <number> to pick directly
/compress (alias /compact)	Manually compress current session context using LLM summarization
/checkpoints	List all checkpoints for the current workspace
/restore	Restore a checkpoint. Shows a picker, or /restore [--force] <id-prefix> to restore directly
/recall	Undo the last user message. If messages are queued, pops the most recent (LIFO). Otherwise aborts any in-flight LLM call and drops that turn from history
/steering <message>	Add guidance to the currently active LLM turn — injected before the next iteration without interrupting active tool calls

Scheduling and Automation

Task Management

Command	Description
/task	Show task status overview
/task status	Detailed task status
/task list	List all tasks
/task stop <name|index|all>	Stop one or all tasks
/task continue <name|index|all>	Continue paused or failed tasks
/task force-complete	Mark all non-terminal tasks as completed

Cron Jobs

Command	Description
/cron	Show cron scheduler status
/cron list	List all cron jobs
/cron show <id>	Show details of a specific cron job
/cron add	Add a new cron job interactively
/cron add-memory	Add a memory maintenance cron job
/cron set-schedule	Modify an existing job's schedule
/cron enable	Enable cron scheduling
/cron disable	Disable cron scheduling
/cron task add	Add a task to a cron job
/cron task edit	Edit a cron task
/cron task del	Delete a cron task
/cron del	Delete a cron job
/cron run <id>	Trigger a cron job immediately
/cron review	Review recent cron run results and logs

Loop and Goal

Command	Description
/loop <interval> <prompt>	Run a prompt repeatedly at a fixed interval (e.g., /loop 5m check build status)
/loop <prompt>	Run a prompt in self-paced mode — UGENT schedules the next iteration based on completion
/loop status	Show running loops
/loop list	List all loops
/loop stop <id|all>	Stop a specific loop or all loops
/goal <objective>	Set a persistent objective that UGENT works toward across turns
/goal status	Show current goal progress
/goal pause	Pause goal pursuit
/goal resume	Resume a paused goal
/goal clear	Clear the current goal

Configure verification gates so a goal cannot report completion until your own checks pass. See Autonomous Runs.

Continual Harness

Off by default; set [harness] enabled = true to make these available. Nothing a refinement proposes is applied until you approve it. See Continual Harness.

Command	Description
/refine [focus]	Read this session's trajectory and queue proposed edits to the durable harness. Nothing is applied
/harness (or /harness list)	Show pending proposals and the current entry set
/harness show <id>	Full detail for one proposal, including the exact text that would be injected
/harness approve <id>	Apply a proposal to the entry set. It appears in the next turn's context
/harness reject <id>	Discard a proposal without applying it
/harness rollback <refinement-id>	Undo every approved edit from one refinement pass

UI Panels

Command	Description
/monitor	Toggle the monitoring panel (also Ctrl+I) — shows metrics, resource usage, and backpressure
/debug	Toggle the debug log panel (also Ctrl+D) — includes memory recall and feedback lines
/status-bar	Switch the bottom status bar widget. Options: mascot, pixel, toggle
/subagents	Toggle the Sub-Agents panel (also Ctrl+F). Navigate with Up/Down, Enter for detail, Shift+Enter for all, q to close
/btw	Show read-only status of this session's delegated sub-agents. Out-of-band — never enters the agent's context