First Session

Once you have installed the CLI and configured your API keys, you are ready to start your first session with Niko.

Starting a Session

Open your terminal and run:

bx

This launches an interactive session with Niko, the Betwixt orchestrator agent. Niko acts as the single entry point for all your AI interactions -- it understands your request, breaks it into sub-tasks, and routes each piece to the specialist model best suited for the job.

Your First Prompt

Try a prompt that exercises multiple capabilities:

Build a REST API endpoint in Rust that accepts a JSON payload,
validates it, and stores it in PostgreSQL. Include unit tests.

Niko will:

1. Analyze the request and identify the required skills (backend code, database schema, testing)
2. Route the Rust implementation to Codex, the database schema to Claude, and the test scaffolding in parallel
3. Synthesize the results into a coherent response with all the files you need

Understanding the Output

During processing, you will see status indicators showing which agents are active:

• A purple indicator means Niko is thinking or coordinating
• Named agent labels (Claude, Codex, Gemini) show which specialist is handling each sub-task
• Memory references appear when Niko retrieves context from previous sessions

Session Memory

Everything discussed in a session is automatically stored in Memory-OS. In your next session, Niko already knows:

• What you built previously
• Decisions you made and why
• API contracts and schemas
• Lessons learned from debugging

You never have to repeat context. Start a new session tomorrow and pick up exactly where you left off.

Next Steps

• Explore How Niko Works to understand the orchestration model
• Learn about Agent Routing to see how tasks are matched to models