A command-line interface for AI-powered code generation with human-in-the-loop approval.
# Install dependencies
poetry install
# Run CLI
poetry run vibe --help
# Or activate shell for direct access
poetry shell
vibe --help| Command | Description | Example |
|---|---|---|
vibe generate "prompt" |
Generate code from prompt | vibe generate "create a login form" |
vibe chat |
Start interactive REPL mode | vibe chat |
vibe --help |
Show all commands | vibe --help |
vibe --version |
Show version | vibe --version |
| Command | Description | Example |
|---|---|---|
vibe agents list |
List all agents | vibe agents list |
vibe agents create -n "name" |
Create new agent | vibe agents create -n "Builder" -f react |
vibe agents use <id> |
Set default agent | vibe agents use 1 |
Create Options:
| Option | Short | Description | Default |
|---|---|---|---|
--name |
-n |
Agent name | required |
--description |
-d |
Agent description | "AI code generation agent" |
--framework |
-f |
Framework (react/vue/html) | react |
--use/--no-use |
Set as default after creation | --use |
Example:
vibe agents create -n "React Builder" -d "Builds React components" -f react| Command | Description | Example |
|---|---|---|
vibe config show |
Show current config | vibe config show |
vibe config set <key> <value> |
Set a config value | vibe config set default_agent_id 1 |
vibe config reset |
Reset to defaults | vibe config reset |
Available Config Keys:
| Key | Description | Default |
|---|---|---|
api_url |
Backend API URL | http://localhost:8000 |
timeout |
Request timeout (seconds) | 120 |
default_agent_id |
Default agent ID | none |
default_framework |
Default framework | react |
hitl_enabled |
Human-in-the-loop enabled | true |
workspace |
Output directory | . |
theme |
CLI theme (dark/light/auto) | auto |
vibe generate "your prompt here" [OPTIONS]| Option | Short | Description | Example |
|---|---|---|---|
--agent |
-a |
Agent ID to use | -a 1 |
--framework |
-f |
Framework override | -f vue |
--output |
-o |
Output file path | -o ./src/Button.tsx |
--no-hitl |
Skip approval prompt | --no-hitl |
Examples:
# Basic usage (uses default agent)
vibe generate "create a navbar component"
# Specify agent
vibe generate "create a button" --agent 1
# Specify framework
vibe generate "create a modal" -f vue
# Specify output location
vibe generate "create utils" -o ./src/utils/helpers.ts
# Auto-approve (skip HITL)
vibe generate "create a card" --no-hitl| Command | Description | Example |
|---|---|---|
vibe pending |
List pending approvals | vibe pending |
vibe status <thread_id> |
Check workflow status | vibe status abc-123 |
vibe approve <thread_id> |
Approve pending workflow | vibe approve abc-123 |
vibe reject <thread_id> |
Reject pending workflow | vibe reject abc-123 |
vibe history <agent_id> |
Show agent's history | vibe history 1 |
Start an interactive session:
vibe chatSlash Commands:
| Command | Description |
|---|---|
/help |
Show help |
/agent <id> |
Switch to different agent |
/framework <name> |
Change framework (react/vue/html) |
/hitl on|off |
Toggle human-in-the-loop |
/pending |
Show pending approvals |
/status <thread> |
Check thread status |
/clear |
Clear screen |
/exit |
Exit chat (or Ctrl+D) |
Multi-line Input:
- Press
Entertwice to submit - Use
Ctrl+Enterfor newline within input
# Start backend + database
docker compose up -d backend postgres
# Run CLI
poetry run vibe chat
# Or run CLI in Docker
docker compose run --rm cli# Terminal 1: Start PostgreSQL (or use Docker)
docker compose up -d postgres
# Terminal 2: Start backend
poetry run uvicorn backend.main:app --reload
# Terminal 3: Run CLI
poetry run vibe chatpoetry shell
vibe agents listFind your virtualenv:
poetry env info --pathAdd to PowerShell profile:
# Open profile
notepad $PROFILE
# Add this line (replace with your path)
$env:PATH += ";D:\poetry_envs\vibearchitect-cli-XXXXX-py3.13\Scripts"pip install pipx
pipx install . --editable├── backend/ # FastAPI backend
│ ├── core/ # Config, database
│ ├── modules/
│ │ ├── agent/ # LangGraph agent
│ │ └── users/ # Authentication
│ └── main.py # App entry point
├── cli/ # Typer CLI
│ ├── commands/ # CLI commands
│ ├── repl/ # Interactive mode
│ ├── ui/ # Rich console UI
│ ├── client.py # API client
│ ├── config.py # CLI configuration
│ └── main.py # CLI entry point
├── frontend/ # Next.js frontend
├── docker-compose.yml # Multi-service orchestration
└── pyproject.toml # Dependencies
| OS | Path |
|---|---|
| Windows | C:\Users\<username>\.vibe\config.toml |
| Linux/Mac | ~/.vibe/config.toml |
Create a .env file in the project root:
# Database
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
POSTGRES_DB=vibearchitectcli
DATABASE_URL=postgresql+asyncpg://postgres:postgres@localhost:5432/vibearchitectcli
# Auth
SECRET_KEY=your-secret-key-here
# OpenAI
OPENAI_API_KEY=sk-...
# CLI (optional, for Docker)
VIBE_API_URL=http://localhost:8000# 1. Start services
docker compose up -d backend postgres
# 2. Create your first agent
vibe agents create -n "React Builder" -f react
# 3. Generate code
vibe generate "create a todo list component with add/delete functionality"
# 4. Or use interactive mode
vibe chat
# 5. Check your config
vibe config show
# 6. View generation history
vibe history 1MIT