Commands

simse has two modes:

Mode	Launch	How to use
TUI (default)	simse	Interactive terminal UI -- type / to enter slash commands
Print	simse --print	Non-interactive -- outputs to stdout

Auth commands (simse login, simse logout) work outside the TUI as standalone subcommands.

---

CLI flags

These flags are passed directly to the simse binary.

Flag	Description
-v, --verbose	Enable verbose output
--format <text|json>	Output format (default: text)
--provider <URL>	Use an alternative OpenAI-compatible provider URL
--model <NAME>	Override model name (used with --provider)
-c, --continue	Continue the last session for the current working directory
--resume <SESSION_ID>	Resume a specific session by ID
--print	Non-interactive mode (output to stdout)
-p, --prompt <TEXT>	Prompt text for print mode

Examples

# Start interactively
simse

# Continue your last session
simse --continue

# Resume a specific session
simse --resume abc123

# Run a one-shot prompt
simse --print -p "explain the auth module"

# Use a custom provider
simse --provider https://api.example.com/v1 --model my-model

# JSON output for scripting
simse --print --format json -p "list open tasks"

---

Subcommands

Subcommands are invoked directly from your shell.

Command	Description
simse login	Log in to your simse account
simse logout	Log out and clear credentials
simse resume [SESSION_ID]	Resume a previous session
simse fork <SESSION_ID> --at <MESSAGE_INDEX>	Fork a session at a specific message
simse mcp restart	Restart MCP server connections
simse mcp status	Show MCP connection status
simse acp restart	Restart ACP server connections
simse acp status	Show ACP server status
simse plugins list [--type <skill|hook|mcp|acp>]	List installed plugins
simse daemon	Run as a background daemon, maintaining a persistent tunnel connection

---

TUI slash commands

Launch simse to open the interactive terminal UI. Type / to see all available commands.

General

Command	Alias	Description
/help [command]	?	Show help or help for a specific command
/clear		Clear the screen
/verbose [on|off]	v	Toggle verbose output
/permissions	plan	Cycle permission mode
/context		Show context usage (tokens)
/compact		Compact conversation history
/exit	quit, q	Exit simse

Sessions

Command	Alias	Description
/resume [id]	r	Resume a previous session
/fork [at_message]		Fork the current session at a message index

Connections

Command	Description
/server [name]	Show or change the active ACP server (LLM provider). Without an argument, prints the current server. With a name, switches to that server.
/model [name]	Show or change the active model. Without an argument, prints the current model. With a name, switches to that model on the active server.
/status	Show connection status
/mcp [restart]	MCP management
/acp [restart]	ACP management

Tools & workspace

Command	Description
/diff [path]	Show file diffs
/plugins [type]	List plugins

Auth

Command	Description
/login	Log in to your simse account
/logout	Log out and clear credentials

---

Built-in tools

These tools are available to the AI model during a session. You don't call them directly -- the model uses them when relevant.

Library

The library is simse's adaptive memory store. It persists knowledge across sessions.

Tool	Description
library_search	Search the library by query (supports maxResults)
library_shelve	Store a new entry with text and topic
library_withdraw	Remove an entry by ID
library_catalog	Browse all topics in the library
library_compact	Summarize a topic into a compact form

Tasks

Task management lets the model track work items across sessions.

Tool	Description
task_create	Create a task with subject and description
task_get	Get a task by ID
task_update	Update a task's status or details
task_delete	Delete a task
task_list	List all tasks