Getting Started

Usage

Using Working Mind day to day -- commands, tool calls, and sessions.

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.

CommandDescription
/ingest <file>Ingest a markdown file into the knowledge graph
/memoryView and manage the knowledge graph
/helpShow available commands
/model <spec>Switch model mid-session
/skill <name>Activate a skill
/sessionManage sessions (resume, new, delete)
/mcp-connect <server>Configure an MCP server
/packView 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

KeyAction
EnterSend message / approve tool call
EscapeCancel current input
Ctrl+CCancel agent execution
Ctrl+DExit Working Mind