4Runr OS - AI Agent Operating System

Interactive terminal for managing AI agents on the 4Runr platform.

Installation

Install globally from npm:

npm install -g 4runr-os

Quick Start

After installation, simply run:

4r

That's it! The OS connects to the official 4Runr server automatically.

Available Commands

You can use any of these commands:

• 4r - Short and simple (recommended)
• 4runr - Full command
• 4runr-os - Full package name

All commands do the same thing - launch the 4Runr OS terminal.

Connect to Local Server (Development)

If you're running a local gateway, set the GATEWAY_URL environment variable:

Windows (PowerShell):

$env:GATEWAY_URL="http://localhost:3001"
4runr

Windows (CMD):

set GATEWAY_URL=http://localhost:3001
4runr

Linux/Mac:

export GATEWAY_URL=http://localhost:3001
4runr

Connect to Custom Server

To use a different server, set GATEWAY_URL:

export GATEWAY_URL=http://your-server.com:3001
4runr

Quick Start

1. Configure AI Provider:

   4runr> config

   Follow the prompts to add your OpenAI or Anthropic API key.

2. Start Chatting:

   4runr> run-agent assistant

   Then just type your messages!

3. Build Custom Agent:

   4runr> build

   Create your own AI agent with custom system prompts.

Available Commands

AI Configuration

• config - Configure AI provider (OpenAI/Anthropic)
• models - List available AI models
• ai-status - Show stored API keys and configuration

Agent Management

• run-agent [name] - Start chatting with an AI agent
• build - Build a custom AI agent (interactive)
• agents - List available agents

Run Management

• create <name> - Create a new run
• start <run-id> - Start a run
• get <run-id> - Get run details
• list - List all runs

System

• status - Show system status
• sentinel - Show Sentinel monitoring
• metrics - Show system metrics
• clear - Clear the screen
• help - Show all commands
• exit - Exit the OS

Examples

Connect to Server and Configure

# Set server URL
export GATEWAY_URL=http://44.222.212.152:3001

# Run OS
4runr

# Configure OpenAI
4runr> config
# Follow prompts...

# Start chatting
4runr> run-agent assistant
Assistant> Hello! How can I help you?

Build Custom Agent

4runr> build
Agent name: code-reviewer
Agent description: Reviews code for bugs and improvements
System prompt: You are an expert code reviewer...
END
Temperature: 0.3
Max tokens: 2000

4runr> run-agent code-reviewer

Requirements

• Node.js 18+
• Access to a 4Runr Gateway (local or remote)

License

MIT