​
Interactive Mode

Atlas’s interactive mode provides a beautiful terminal user interface (TUI) for managing workspaces, triggering signals, and monitoring sessions in real-time.

​
Launching Interactive Mode

Simply run: 
atlas
This launches a dual-panel interface that automatically detects your current workspace.

​
Interface Overview

┌─────────────────────────────────────┬──────────────────────────────────────┐
│ Command History                     │ Logs / Output                        │
│                                     │                                      │
│ > help                             │ Welcome to Atlas Interactive Mode    │
│ > /signal list                     │                                      │
│ > /signal trigger chat             │ Available commands:                  │
│                                     │ - help: Show this help              │
│                                     │ - /signal: Signal commands          │
│                                     │ - /session: Session commands        │
│                                     │ - /ps: List active sessions         │
│                                     │                                      │
└─────────────────────────────────────┴──────────────────────────────────────┘
 Type commands or use / for slash commands. Press Tab to switch panels.

​
Vi-Style Keybindings

  • j / k - Move down/up
  • gg - Jump to top
  • G - Jump to bottom
  • Ctrl+D - Page down
  • Ctrl+U - Page up

​
Panel Controls

  • Tab / Shift+Tab - Switch between panels
  • Enter - Expand long content or copy command
  • Esc - Close expanded view
  • y - Copy selected line to clipboard

​
Command Input

  • / - Start typing slash commands
  • Enter - Execute command
  • ↑ / ↓ - Navigate command history

​
Slash Commands

Atlas uses slash commands for all operations:

​
Signal Commands

# List all signals
/signal list

# Trigger a signal
/signal trigger analyze

# Trigger with data
/signal trigger chat --data {"message": "Hello Atlas!"}

# Trigger with complex data
/signal trigger process --data {
  "file": "report.csv",
  "action": "analyze",
  "output": "summary"
}

​
Session Commands

# List active sessions (shorthand)
/ps

# List with details
/session list

# View session details
/session get <session-id>

# Stream session logs
/session logs <session-id>

# Stop a session
/session stop <session-id>

​
Workspace Commands

# Show current workspace
/workspace current

# List all workspaces
/workspace list

# Switch workspace
/workspace use <workspace-id>

​
Features

​
Auto-Detection

Interactive mode automatically:
  • Detects your current workspace
  • Loads workspace configuration
  • Shows relevant signals and jobs

​
Real-Time Updates

  • Live session status updates
  • Streaming logs from active sessions
  • Progress indicators for running jobs

​
Smart Formatting

  • Syntax highlighting for JSON data
  • Colored log levels
  • Table formatting for lists
  • Timestamp display

​
Clipboard Integration

Press y on any line to copy it to your system clipboard - perfect for:
  • Copying session IDs
  • Grabbing command examples
  • Saving error messages

​
Common Workflows

​
1. Interactive Chat Session

# Start Atlas
atlas

# Trigger conversation
/signal trigger chat --data {"message": "Help me plan a project"}

# Monitor the session
/ps

# View streaming logs
/session logs abc-123-def

​
2. Data Processing Pipeline

# List available signals
/signal list

# Trigger analysis
/signal trigger analyze-data --data {
  "source": "sales_q4.csv",
  "metrics": ["revenue", "growth"]
}

# Watch progress
/ps

​
3. Debugging Sessions

# See what's running
/ps

# Get session details
/session get xyz-789

# Stop if needed
/session stop xyz-789

​
Tips and Tricks

​
1. Quick Commands

Use the shorthand /ps instead of /session list for speed.

​
2. JSON Formatting

The TUI accepts relaxed JSON for --data: 
# Both work:
--data {"key": "value"}
--data '{"key": "value"}'

​
3. Long Output

When output is truncated, press Enter to see the full content in an expanded view.

​
4. Command History

Use arrow keys to quickly re-run previous commands with modifications.

​
5. Multiple Windows

Run multiple Atlas interactive sessions in different terminal windows to monitor various workspaces simultaneously.

​
Troubleshooting

​
”No workspace detected”

Make sure you’re in a directory with a workspace.yml file or run /workspace use <id>.

​
”Cannot connect to daemon”

Check that the Atlas daemon is running: 
atlas daemon status
atlas daemon start  # if not running

​
Logs not streaming

Ensure the session is active and you have the correct session ID. Use /ps to list active sessions.

​
Advanced Usage

​
Custom Keybindings

While Atlas uses vi-style keys by default, you can configure custom keybindings in your shell: 
# Add to ~/.bashrc or ~/.zshrc
alias ai='atlas'  # Quick access

​
Integration with tmux/screen

Atlas’s TUI works great in terminal multiplexers: 
# Create Atlas monitoring setup
tmux new-session -s atlas -d 'atlas'
tmux split-window -h 'atlas logs --follow'
tmux attach -t atlas

​
Next Steps