rizome

Rizome CLI - Agentic Development Environment Workspace Management

built by: rizome labs | contact: hi@rizome.dev

Installation

Homebrew

brew tap rizome-dev/brews && brew install rizome

Source

git clone https://github.com/rizome-dev/rizome && cd rizome && sudo make install

Binary Download

Download the latest binary for your platform from the releases page.

Commands

rizome init

# Create a new RIZOME.md interactively from templates
rizome init

# Force overwrite existing RIZOME.md
rizome init --force

# Use a specific template (non-interactive)
rizome init --template my-template-key

The init command now provides an interactive template selection interface. You can choose from saved templates or create a new one on the fly.

rizome tmpl

# List all available templates
rizome tmpl
rizome tmpl list

# Add a new template interactively
rizome tmpl add
rizome tmpl add "My Template Name"

# Edit an existing template
rizome tmpl edit
rizome tmpl edit "Template Name"

# Show template content
rizome tmpl show
rizome tmpl show "Template Name"

# Delete a template
rizome tmpl delete
rizome tmpl delete "Template Name" --force

Templates are stored in ~/.rizome/config.yaml and can be reused across projects. The template management system allows you to create, edit, and organize reusable RIZOME.md templates.

rizome sync

# Interactive provider selection and preview changes
rizome sync --dry-run

# Interactive provider selection and apply synchronization
rizome sync

# Force overwrite existing files
rizome sync --force

# Non-interactive mode with specific providers
rizome sync --providers claude,qwen,cursor

# Non-interactive mode
rizome sync --non-interactive

The sync command now provides an interactive checkbox interface for selecting which providers to sync. All providers are selected by default, and you can check/uncheck providers as needed.

This will create/update individual provider configuration files:

• CLAUDE.md
• QWEN.md
• CURSOR.md
• GEMINI.md
• WINDSURF.md

RIZOME.md Format

The RIZOME.md file uses a structured format:

• Common Instructions: Instructions that apply to all AI providers
• Provider Overrides: Provider-specific instructions organized by provider name

• CLAUDE - Claude Code and Claude API
• QWEN - Qwen Code and Qwen models
• CURSOR - Cursor AI IDE
• GEMINI - Gemini CLI and Gemini models
• WINDSURF - Windsurf AI development environment

# RIZOME.md

Project overview and context.

## Common Instructions

Instructions that apply to all providers:
- Project type and technology stack
- Coding standards and conventions
- General best practices

## Provider Overrides

### CLAUDE
Claude-specific instructions

### QWEN
Qwen-specific instructions

### CURSOR
Cursor-specific instructions

### GEMINI
Gemini-specific instructions

### WINDSURF
Windsurf-specific instructions

Use Cases

Multi-Provider Development

Keep all your AI development environments synchronized with a single source of truth:

# Initialize a new RIZOME.md from templates (interactive)
rizome init

# Or use a specific template
rizome init --template my-project-template

# Edit RIZOME.md with your project requirements
# Then interactively sync across selected providers
rizome sync

Team Collaboration

Share consistent AI provider configurations across your team:

# Team lead creates and saves a team template
rizome tmpl add "Team Standards"
# Edit template with coding standards
# Then create project RIZOME.md from template
rizome init --template team-standards
git add RIZOME.md
git commit -m "Add coding standards"
git push

# Team members sync their environments
git pull
rizome sync  # Interactive provider selection

Project Templates

Create and manage reusable project templates with pre-configured AI provider settings:

# Create and save reusable templates
rizome tmpl add "Go Backend"
rizome tmpl add "Python ML"
rizome tmpl add "Frontend Project"

# Use templates in new projects
rizome init --template go-backend
# or select interactively
rizome init

# List and manage your templates
rizome tmpl list
rizome tmpl show "React Project"
rizome tmpl edit "React Project"

# Share templates across team (stored in ~/.rizome/config.yaml)
scp ~/.rizome/config.yaml teammate@host:~/.rizome/

Template Management Workflow

# Create templates for different project types
rizome tmpl add "Frontend Project"  # Add React/Vue/Angular specific instructions
rizome tmpl add "Backend API"       # Add API development guidelines  
rizome tmpl add "ML Pipeline"       # Add data science and ML instructions

# Use templates when starting new projects
cd new-frontend-project
rizome init --template frontend-project
rizome sync --providers claude,cursor  # Select specific providers

make help              # Show all available targets
make build             # Build the binary
make test              # Run unit tests
make test-coverage     # Run tests with coverage report
make test-sync         # Test sync command functionality
make lint              # Run linters
make fmt               # Format code
make install           # Install to /usr/local/bin
make uninstall         # Remove installed binary
make clean             # Remove build artifacts

Built with ❤️ by Rizome Labs