Skip to content

Beandon13/RustLabsCli

Repository files navigation

RustLabs CLI

Multi-agent AI orchestration terminal powered by OpenClaw.

Features

RustLabs TUI (Default)

  • 5-tab interface — Run, Logs, Marketplace, Settings, Swarm
  • Multi-agent chat — Stream responses from Claude, Gemini, GPT, Groq & more
  • File attachments@filename to include local files in prompts
  • Session history — Persistent chat sessions with context compaction
  • Skill marketplace — Browse & install agent skills
  • Plan mode — Shift+Tab to toggle plan/execute mode

Swarm Mode

  • Multi-agent grid — 2x2, 3x3, 1x3, or 3x1 layouts
  • Independent agent chats — Each grid cell is a separate agent with its own model
  • Agent presets — Spawn preconfigured agents (coder, ops, data, security, architect)
  • Keyboard-driven — Arrow keys to navigate, S to spawn, X to kill, G to cycle layouts

Traditional CLI

  • Chat — Interactive terminal chat sessions
  • Tasks — Create, list, complete, and delete tasks
  • Config — Switch providers, set API keys, choose models
  • Auth — Login/logout with your RustLabs account

Installation

npm install -g rustlabs-cli

# Launch the TUI (default)
rustlabs
# or use the short alias
rl

Usage

RustLabs TUI (Recommended)

# Launch the full TUI dashboard
rustlabs

# Launch directly into swarm mode
rustlabs swarm
rustlabs swarm --grid 3x3

Keyboard Shortcuts

Global (all tabs):

Key Action
1-5 Jump to tab (Run, Logs, Marketplace, Settings, Swarm)
Tab Cycle to next tab
Esc Back / exit focus

Run tab:

Key Action
Enter Focus chat input
Esc Exit chat to agents panel
Shift+Tab Toggle plan mode
Arrow right Focus history panel

Swarm tab:

Key Action
Arrow keys Navigate grid
Enter Focus chat input
S Spawn new agent
X Kill selected agent
G Cycle grid layout

Swarm CLI

# List available agent presets
rustlabs swarm --list

# Preview a preset
rustlabs swarm --spawn coder

# Export all agent config as JSON
rustlabs swarm --export

Traditional CLI Commands

# Chat with agent (requires auth)
rustlabs chat
rustlabs chat -m gemini-2.5-flash

# Task management (requires auth)
rustlabs tasks --list
rustlabs tasks --add "Build landing page"
rustlabs tasks --complete <id>
rustlabs tasks --delete <id>

# Status & diagnostics (requires auth)
rustlabs status
rustlabs diagnostics

# Configuration
rustlabs config

# Authentication
rustlabs login
rustlabs logout

Agent Presets

Preset Role Model Skills
coder Full-Stack Developer Claude Sonnet 4.6 code-analysis, git-ops, testing
ops DevOps Engineer Claude Sonnet 4.6 docker, kubernetes, ci-cd
data Data Scientist Gemini 2.5 Flash python, sql, visualization
security Security Analyst Claude Opus 4.6 pen-testing, audit, compliance
architect System Architect Claude Sonnet 4.6 design-patterns, documentation

Configuration

Config stored at ~/.config/rustlabs-cli/

# Interactive configuration
rustlabs config

# Or set your API key directly in the TUI (tab 4 → Settings)

Providers

Provider Notes
OpenRouter One key, 500+ models (recommended)
Google Gemini Direct Gemini API access
Groq Free tier, fast inference
Anthropic Direct Claude API
OpenAI Direct GPT API

Tech Stack

  • Node.js 18+ / TypeScript
  • Ink v5 — React for CLI
  • Zod — Config validation

Development

npm run dev    # Run with tsx (dev mode)
npm run build  # Build TypeScript
npm run start  # Run built version

License

MIT


rustlabs.ai — Cloud sync, team workspaces & unlimited agents

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors