Interface and commands

# Interactive mode, used by default when no prompt is passed
soba

# Explicit interactive mode
soba -i

# Start with a theme
soba --theme forest

# Continue a specific session
soba -s abc123

# Continue the latest session in the TUI
soba -c

# Open the session picker
soba -r

┌──────────────────────────────────────────────────────┐
│  SOBA  Agent  [-][_][×]    Budget: 12K/64K    EN │
│──────────────────────────────────────────────────────│
│  ● Active    soba-agent                               │
│──────────────────────────────────────────────────────│
│  You: Fix all TypeScript errors in src/              │
│                                                      │
│  Agent: Analyzing...                                 │
│  ┌────────────────────────────────────────────────┐   │
│  │ 🔧 read: src/utils/parser.ts                   │   │
│  │    ...                                         │   │
│  └────────────────────────────────────────────────┘   │
│  ┌────────────────────────────────────────────────┐   │
│  │ ✅ edit: Fixed 3 type errors                   │   │
│  └────────────────────────────────────────────────┘   │
│  Agent: Done. Fixed 3 errors in parser.ts.          │
│──────────────────────────────────────────────────────│
│  > _                                                  │
└──────────────────────────────────────────────────────┘

# Run one command
!ls -la src/

# Repeat the previous shell command
!!

# Check Node version
!node --version

# Inspect git status
!git status

# Run tests
!bun test

# The agent is working on the first request
> Fix all TS errors                                  # → Task 1, running

# Add more work while it is still busy
> Add tests for utils                                # → Queue, position 1
> Update README with new features                    # → Queue, position 2

# Inspect the queue
/queue
# Output: Queue (2 tasks)
#   1. Add tests for utils
#   2. Update README with new features

# Clear the queue
/queue clear

# Show budget
/budget

# Output:
#   Used:      28,450 tokens
#   Limit:     64,000 tokens (context window)
#   Available: 35,550 tokens
#   Messages:  42
#   Turns:     8
#   Capsules:  2

# More context details
/budget
/session

# Output:
#   Effective tokens:   32,100
#   Hard limit:         47,616
#   Safety reserve:     8,192
#   Max output:         8,192
#   Reclaimable:        12,100
#   Auto-compact:       ON

/             # Tab →
help         session      compact      budget
auto-compact capsule      config       lang
theme         skill       project-trust exit
quit          clear       search       notifications
permissions   queue

/skill        # Tab →
/skill list    /skill new     /skill edit
/skill eval    /skill bench   /skill trace
/skill remove  /skill:

# Switch theme
/theme forest

# Show the current theme
/theme

# Available themes:
# graphite, aurora, synthwave, paper,
# forest, highContrast, clay, operator, ink

# Switch language in the TUI
/lang en

# At startup
soba --lang en

# In config
{
  "lang": "en"
}