Interactive Mode (Sherpa)

Sherpa is Metaphori's interactive REPL (Read-Eval-Print Loop) for extended AI conversations with compressed context.

Starting Sherpa REPL

Basic Start

metaphori sherpa

This starts an interactive session where you can have multi-turn conversations with AI models.

Start Options

Start in chat mode:

metaphori sherpa --chat

Optimized for conversational interactions.

With specific model:

metaphori sherpa -m claude-3-5-sonnet

REPL Commands

Once in Sherpa mode, you can use these commands:

Compression Commands

/compress use mph_c_xxxxx    # Use compression in session
/compress list               # List available compressions
/compress clear              # Stop using compression

Model Commands

/model list                  # List available models
/model set gpt-4o            # Change model

Session Commands

/session save my-session     # Save current session
/session load session-id     # Load saved session
/messages show               # Show conversation history

Utility Commands

/cost                        # Show cost estimate
/clear                       # Clear conversation
/help                        # Show all commands
/exit                        # Leave REPL

Chat Mode Features

Multi-turn Conversations

Sherpa maintains context across multiple exchanges:

metaphori sherpa
Sherpa v1.2.0 - Interactive mode
Type /help for commands
> Explain the main function in my compression
The main function initializes the server with...
> How can I optimize the database queries?
Based on the code in your compression, here are optimization suggestions...

File References

Include files in your prompts:

> Review @package.json and suggest improvements
Looking at your package.json file...

Dynamic Compression Loading

Switch compressions mid-conversation:

> /compress use mph_c_frontend_code
✓ Now using compression: Frontend React App
> What components need refactoring?
Analyzing your React components...

Session Management

Saving Sessions

Save your conversation for later:

> /session save code-review-2024-01
✓ Session saved: code-review-2024-01 (ID: sess_abc123)

Loading Sessions

Continue previous conversations:

> /session load sess_abc123
✓ Loaded session: code-review-2024-01
✓ 15 messages restored

Cost Management

Monitor your token usage and costs:

> /cost
Session Statistics:
- Messages: 12
- Total tokens: 45,231
- Input tokens: 41,892
- Output tokens: 3,339
- Estimated cost: $0.73
- Compression savings: 68%

Tips and Tricks

🎯 Start with a Compression

Load your compression first with /compress use for better context.

💡 Use File References

Combine compressions with @file references for complete context.

💾 Save Important Sessions

Use /session save for conversations you want to continue later.

🔄 Switch Models Freely

Try different models with /model set to compare responses.

Example Workflow

# Start Sherpa with Claude
$ metaphori sherpa -m claude-3-5-sonnet
Sherpa v1.2.0 - Interactive mode
> /compress list
1. mph_c_backend - API Backend Code
2. mph_c_frontend - React Frontend
3. mph_c_docs - Documentation
> /compress use mph_c_backend
✓ Now using compression: API Backend Code
> Review the authentication flow and suggest security improvements
Analyzing your authentication implementation...
> /session save security-review
✓ Session saved: security-review

Ready to configure Metaphori?

Learn about configuration options and environment variables.

Continue to Configuration →