viben

v0.1.1

Published

21 days ago

CLI for Viben - Orchestrate AI agent clusters in your local workspace

Downloads

215

0High
0Medium
0Low

linxueyuan

viben browse-mcp mcp ai agent orchestration workspace claude automation cli

Viben CLI

Command-line interface for Viben - orchestrate AI agent clusters in your local workspace.

Installation

Quick Start with npx (Recommended)

No installation needed - just run:

npx viben --help

Global Installation

npm install -g viben
viben --help

Commands

Workspace Commands

# Initialize a workspace
viben init
viben init --from <template>

# Manage configuration (git-style)
viben config list                    # List all config
viben config list --show-origin      # Show config sources
viben config get <key>               # Get a value
viben config set <key> <value>       # Set a value
viben config unset <key>             # Remove a value
viben config edit                    # Open in editor

# Manage agents
viben agent list                     # List all agents
viben agent create -n <id>           # Create new agent
viben agent show -n <id>             # Show agent details

Server Commands

# Start MCP server (wraps browse-mcp Python package)
viben serve                          # Start in stdio mode
viben serve -t sse --port 8080       # Start SSE server
viben mcp                            # Alias for serve

Global Options

--json          Output in JSON format (for agent consumption)
-g, --global    Use global scope (~/.viben/)
-w, --workspace Use workspace scope (.viben/)
--verbose       Enable verbose output
-q, --quiet     Suppress non-essential output
-v, --version   Show version
-h, --help      Show help

Configuration

File Locations

Global config: ~/.viben/config.yaml
Workspace config: <project>/.viben/config.yaml
Global agents: ~/.viben/agents/*.yaml
Workspace agents: <project>/.viben/agents/*.yaml

Environment Variables

VIBEN_STATE_DIR   # Override state directory (default: ~/.viben)
VIBEN_AGENT       # Current agent ID
VIBEN_SCOPE       # Default scope (global/workspace)

Config File Format

# .viben/config.yaml
version: 1

settings:
  editor: code
  pager: less
  color: auto

agents:
  - main

mcp:
  enabled:
    - filesystem
    - git

skills:
  enabled:
    - code-review

JSON Output Mode

All commands support --json for structured output:

# Human-readable (default)
viben agent list
# ID    Name        Model      Source
# main  Main Agent  (default)  workspace

# JSON output
viben --json agent list
# {
#   "success": true,
#   "data": {
#     "agents": [{ "id": "main", "name": "Main Agent", ... }],
#     "count": 1
#   }
# }

MCP Server

The serve command wraps the browse-mcp Python package.

Requirements

Node.js 18+ - For the CLI
Python 3.10+ - For the MCP server
pip or uv - For Python package installation

MCP Client Configuration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "viben": {
      "command": "npx",
      "args": ["viben", "serve"]
    }
  }
}

Claude Code

Add to ~/.config/claude/config.json:

{
  "mcpServers": {
    "viben": {
      "command": "npx",
      "args": ["viben", "serve"]
    }
  }
}

License

MIT