REPL Interface

REPL Interface#

The REPL (Read-Eval-Print Loop) provides a feature-rich command-line interface for interacting with Pantheon agents and teams.

Quick Start#

Start the REPL with default settings:

pantheon cli

You’ll see a welcome message and prompt. Type your message and press Enter to chat with the agent.

╭─ Pantheon REPL ─╮
│ Type /help for commands │
╰──────────────────────────╯

> Hello! What can you help me with?

Starting Options#

# Use a specific team template
pantheon cli --template data_research_team

# Set memory directory
pantheon cli --memory-dir ./my_chats

# Resume a previous chat
pantheon cli --chat-id abc123

# Quiet mode (less output)
pantheon cli --quiet

Key Features#

Syntax Highlighting#

Code in responses is automatically highlighted:

> Write a Python hello world

Here's the code:

```python
print("Hello, World!")
```

File Viewer#

View files with syntax highlighting using /view:

> /view src/main.py

This opens a full-screen viewer with:

  • Line numbers

  • Syntax highlighting

  • Vim-style navigation (j/k, g/G)

  • Page navigation (Space, Ctrl-F/B)

See File Viewer for details.

Command History#

  • Use arrow keys to navigate previous commands

  • History persists across sessions

  • Stored in ~/.pantheon/cli_history

Auto-Completion#

  • Tab completion for commands

  • File path completion

Multi-line Input#

For multi-line messages, use triple backticks:

> ```
This is a
multi-line
message
```

Common Commands#

Command

Description

/help

Show available commands

/view <file>

View file with syntax highlighting

/clear

Clear conversation context

/compress

Compress conversation to save tokens

/exit

Exit the REPL

See REPL Commands for the complete reference.

Configuration#

REPL settings are stored in .pantheon/settings.json:

{
  "repl": {
    "quiet": false,
    "default_template": "default",
    "log_level": "ERROR"
  }
}

See Settings Reference for all options.

Next Steps#