Usage
The Terminal UI
Working Mind runs as a terminal UI (TUI) built with OpenTUI -- a React-based terminal rendering framework. The chat interface, tool call panels, sidebar, and input bar are all React components rendered directly in the terminal.
You type messages at the bottom, the agent responds above. Tool calls are shown inline with their results.
Slash Commands
Commands provide structured workflows beyond free-form chat.
| Command | Description |
|---|---|
/ingest <file> | Ingest a markdown file into the knowledge graph |
/memory | View and manage the knowledge graph |
/help | Show available commands |
/model <spec> | Switch model mid-session |
/skill <name> | Activate a skill |
/session | Manage sessions (resume, new, delete) |
/mcp-connect <server> | Configure an MCP server |
/pack | View loaded pack info |
Tool Calls
When the agent decides to use a tool (search the web, save to memory, scrape a URL), you see the tool call in the terminal. By default, tool calls require your approval. Press Enter to approve, or type a reason to deny.
Use --auto-approve or set agents.autoApprove: true in config to skip approvals.
Sessions
Working Mind saves your conversation history between sessions. When you reopen the app, you can resume where you left off.
/session-- open the session manager- Choose "Resume a session" to continue a previous conversation
- Choose "Start new session" to start fresh
Your knowledge graph persists across all sessions. The conversation history is per-session, but the memory graph is shared.
Sending Messages
Just type your message and press Enter. The agent will respond, potentially calling tools along the way.
Examples:
Remember that the production server is at 192.168.1.100
What do I know about the deployment pipeline?
Search the web for "React 19 server components best practices"
Scrape https://example.com/docs and extract the key concepts
Key Bindings
| Key | Action |
|---|---|
Enter | Send message / approve tool call |
Escape | Cancel current input |
Ctrl+C | Cancel agent execution |
Ctrl+D | Exit Working Mind |