rodger

Official CLI tool for Rodger.ai - Build and manage AI agents.

Installation

npm install -g rodger

Or use directly with npx:

npx rodger <command>

Quick Start

Create a new agent project:

npx rodger init my-agent
cd my-agent
npm install

Add your API keys to .env:

OPENAI_API_KEY=sk-...

Start development server:

rodger dev

Commands

Core Commands

init [name]

Scaffold a new Rodger agent project.

rodger init my-support-bot

# With template
rodger init my-agent --template knowledge-agent

Available Templates:

• basic-chat - Simple Q&A chatbot
• knowledge-agent - Agent with RAG knowledge base
• tool-agent - Agent with custom tools
• loan-assistant - Full-featured example

dev

Start the local development server.

rodger dev

# Custom port
rodger dev --port 3001

test <message>

Test your agent with a message.

rodger test "Hello, what can you help with?"

# Stream response
rodger test "Tell me a story" --stream

# With session ID
rodger test "Continue our conversation" --session-id abc123

Knowledge Commands

Manage your agent's knowledge base (Ragie or Zep).

knowledge upload <file>

Upload a document to the knowledge base.

rodger knowledge upload ./docs/faq.pdf

# With metadata
rodger knowledge upload ./docs/guide.txt --metadata '{"category": "support"}'

Supported formats: PDF, TXT, MD, DOCX, and more.

knowledge search <query>

Search the knowledge base.

rodger knowledge search "password reset"

# Limit results
rodger knowledge search "billing" --limit 10

knowledge status <documentId>

Check document processing status.

rodger knowledge status doc_abc123

Guardrails Commands

Test and validate guardrail rules.

guardrails test

Run the guardrail test suite.

rodger guardrails test

# Verbose output
rodger guardrails test --verbose

Tests common violations:

• PII detection (emails, SSNs, phone numbers)
• Toxic content
• Off-topic queries
• Custom rules

guardrails validate <text>

Validate text against guardrail rules.

rodger guardrails validate "My email is [email protected]"

Environment Variables

Required (at least one)

• OPENAI_API_KEY - OpenAI API key
• ANTHROPIC_API_KEY - Anthropic API key

Optional (for knowledge base)

• RAGIE_API_KEY - Ragie API key
• ZEP_API_KEY - Zep Cloud API key
• ZEP_COLLECTION - Zep collection name (default: "default")

Project Structure

After running rodger init, you'll have:

my-agent/
├── agent.config.ts       # Agent configuration
├── app/
│   └── api/
│       └── chat/
│           └── route.ts  # Chat API endpoint
├── package.json
├── .env                  # Environment variables
└── tsconfig.json

Configuration

Edit agent.config.ts to customize your agent:

import { createAgent } from '@rodger/core';

export const agent = createAgent({
  name: 'My Agent',

  llm: {
    provider: 'openai',
    model: 'gpt-4o-mini',
    apiKey: process.env.OPENAI_API_KEY!,
  },

  systemPrompt: 'You are a helpful assistant...',

  // Add knowledge base
  knowledge: {
    provider: 'ragie',
    apiKey: process.env.RAGIE_API_KEY!,
  },

  // Add guardrails
  guardrails: [
    {
      name: 'pii-detection',
      type: 'input',
      // ... config
    },
  ],
});

Examples

Test agent locally

# Quick test
rodger test "Hello!"

# Stream response
rodger test "Write a poem" --stream

# Test with session
rodger test "What's my name?" --session-id user_123

Upload documentation

# Upload support docs
rodger knowledge upload ./docs/faq.pdf

# Upload with metadata
rodger knowledge upload ./docs/v2-guide.md --metadata '{"version": "2.0"}'

Validate guardrails

# Test all guardrails
rodger guardrails test

# Validate specific text
rodger guardrails validate "My SSN is 123-45-6789"

Troubleshooting

Missing API keys

If you see API key errors:

1. Check .env file exists
2. Verify API keys are set correctly
3. Restart dev server after changing .env

TypeScript errors

Make sure you're running from the project root directory where agent.config.ts exists.

Knowledge upload fails

Verify your knowledge provider API key:

# For Ragie
echo $RAGIE_API_KEY

# For Zep
echo $ZEP_API_KEY

Learn More

• Documentation
• Examples
• GitHub

License

MIT