Local Testing

cd my-agent/
rf test

# Start with default settings (auto-detects port, opens browser)
cd agent-name/
rf test

http://localhost:PORT/agents/your-agent/test-monitor

# Start on specific port
rf test --port 4500

# Start server without opening browser
rf test --no-browser

cd my-agent/
rf test

# 1. Edit src/index.ts in your editor
# 2. Save the file
# 3. Server automatically detects changes
# 4. Agent reloads with new code
# 5. Test immediately in web interface

# 1. Navigate to your agent directory
cd my-agent/

# 2. Start test server (opens browser automatically)
rf test
# → Server started at http://localhost:3847
# → Browser opened

# 3. Test your agent in web interface:
# - Send test messages
# - View real-time traces
# - Check costs and performance
# - Debug issues

# 4. Make changes to your code
# ... edit src/index.ts in your editor ...
# ... save file ...

# 5. Changes automatically reload (watch console)
# → File changed: src/index.ts
# → Reloading agent...
# → Agent reloaded

# 6. Test updated agent immediately (no restart needed)

# 7. Repeat steps 4-6 until satisfied

# 8. Stop server (Ctrl+C) and deploy
rf agents deploy

# Terminal 1: Keep test server running
cd my-agent/
rf test

# Terminal 2 / IDE: Make changes
# Edit code → Save → Test
# Edit code → Save → Test
# Repeat...

# 1. Create and populate KB
rf kb create test-kb --embedding "OpenAI Small"
rf kb upload test-kb ./test-docs --yes

# 2. Update agent to use KB
# ... edit src/index.ts to reference 'test-kb' ...

# 3. Test with live reload
rf test
# → Make changes → Auto-reload → Test

Execution: exec_abc123
Duration: 2.4s
Cost: $0.0023
Status: Success

Traces:
└─ Agent Start
   ├─ KB Query: "user question"
   │  └─ Results: 3 chunks (0.92, 0.87, 0.81)
   ├─ LLM Call: gpt-4
   │  └─ Tokens: 450 in, 120 out
   └─ Agent Complete

{
  "executionId_1": {
    "traces": [...],
    "summary": {...}
  },
  "executionId_2": {
    "traces": [...],
    "summary": {...}
  }
}

# Specify a different port
rf test --port 4500

# Or let it auto-select
rf test
# → Port 3847 in use, trying 3848...

# Check if file exists
ls .runflow/rf.json

# If not, you're in the wrong directory
cd path/to/my-agent/
rf test

Error: No agent configuration found

# Start without browser and open manually
rf test --no-browser

# Check terminal for URL
# Server started at http://localhost:3847

# Open manually in browser
open http://localhost:3847

# Manual restart if needed
# Ctrl+C to stop
rf test

rf test
# Error: Cannot find module 'some-package'

npm install
# or
yarn install
# or
pnpm install

# Then try again
rf test

rf test
# Error: No API key found

# Login first
rf login

# Then test
rf test

# Fix permissions if needed
chmod -R 755 .runflow/

# Test again
rf test

# Use specific port (useful for consistent URLs)
rf test --port 3000

# Always accessible at same URL
# http://localhost:3000

# Terminal 1
cd agent-1/
rf test --port 3000

# Terminal 2
cd agent-2/
rf test --port 3001

# Terminal 3
cd agent-3/
rf test --port 3002

#!/bin/bash

# Test agent in CI pipeline
cd my-agent/
rf test --no-browser --port 4000 &
TEST_PID=$!

# Wait for server to start
sleep 5

# Run automated tests against http://localhost:4000
curl http://localhost:4000/health
npm run test:integration

# Stop test server
kill $TEST_PID

Execution Time: 5.2s
├─ KB Query: 1.2s
├─ LLM Call: 3.8s
└─ Other: 0.2s