Vibe Workspace

MCP License: MIT MSRV Cargo Downloads

A lightweight CLI tool designed to help developers quickly adopt vibe-coding patterns across multiple repositories.

Vibe Workspace streamlines your development workflow by providing consistent environments, tooling configurations, and coding patterns for modern AI Agentic coding.

Features

• 🚀 Instant Setup - Get productive in seconds with pre-configured vibe patterns
• 🎯 Pattern Enforcement - Consistent coding patterns across all your repositories
• 📁 Multi-Repository Management - Orchestrate vibe patterns across entire organizations
• 🆕 Quick Prototyping - Create new repositories instantly with vibe create
• 🔧 Developer Tool Integration - Pre-configured Warp, iTerm2, WezTerm, VS Code, Cursor, and Windsurf templates
• 🎨 Vibe Templates - Ready-to-use configurations for different tech stacks
• 🔄 Pattern Propagation - Apply vibe patterns to new and existing repositories
• 📱 Menu Mode - Guided setup for vibe-coding workflows
• 🤖 MCP Support - Model Context Protocol server for AI integration
• 🛠️ Extensible - Create custom vibe patterns for your team

Platform Support

Currently, macOS is the only officially tested and supported platform, with universal binaries available for both arm64 and amd64 architectures.

We cross-compile to Linux distributions, but full testing and support is not yet complete. Windows support is technically possible but not currently on the short-term roadmap unless highly requested by the community.

Installation

Recommended (macOS)

For the fastest installation on macOS, first ensure you have cargo-binstall:

brew install cargo-binstall

Then install vibe-workspace:

cargo binstall vibe-workspace

From Cargo (Build from Source)

cargo install vibe-workspace

From Source

git clone https://github.com/toolprint/vibe-workspace
cd vibe-workspace
cargo install --path .

Quick Start

Get started with the interactive setup wizard:

# Run the setup wizard (recommended for first-time users)
vibe setup

# Or launch the interactive menu
vibe

The setup wizard will:

1. Discover repositories in your workspace automatically
2. Check installed apps (VS Code, Warp, iTerm2, WezTerm, Cursor, Windsurf)
3. Configure default app for opening repositories

After setup, use these essential commands:

vibe launch                # Interactive recent repository selector
vibe create my-prototype   # Create new repository for prototyping  
vibe clone <github-url>    # Clone, configure, and open in one command
vibe                       # Interactive menu with smart actions

For detailed getting started guide, see Quick Start Guide.

Supported Applications

• Warp Terminal - Modern terminal with AI features and collaborative tools
• iTerm2 - Feature-rich terminal emulator for macOS
• WezTerm - GPU-accelerated cross-platform terminal
• Visual Studio Code - Popular code editor with extensive plugin ecosystem
• Cursor - AI-first code editor with built-in AI assistance and chat
• Windsurf - Agentic IDE powered by AI Flow paradigm

For detailed app configuration, templates, and additional developer tools, see App Integration Guide.

Configuration

Vibe stores its configuration and data in ~/.toolprint/vibe-workspace/:

~/.toolprint/vibe-workspace/
├── config.yaml          # Main workspace configuration
├── state.json           # User preferences and recent repositories
├── templates/           # App-specific templates
│   ├── warp/
│   ├── iterm2/
│   ├── wezterm/
│   ├── vscode/
│   ├── cursor/
│   └── windsurf/
├── cache/               # Performance caches
│   ├── repositories.db  # Repository metadata cache
│   └── git_status.db   # Git status cache
└── backups/            # Configuration backups

Key Configuration Files:

• config.yaml - Repository definitions, app settings, and workspace configuration
• state.json - Recent repositories, user preferences, and setup completion status
• templates/ - Customizable templates for how apps open repositories

Use these commands to manage configuration:

vibe config show           # View current configuration
vibe config edit           # Edit configuration file
vibe config backup         # Create backup archive
vibe config reset          # Factory reset (with confirmation)

MCP Integration

vibe-workspace includes built-in MCP (Model Context Protocol) server capabilities for AI integration.

Claude Code Integration

After installing the vibe-workspace binary on your system, you can add it to Claude Code with:

claude mcp add -s user -t stdio vibe vibe mcp

For detailed MCP configuration and capabilities, see MCP Documentation.

Development

Building

# Development build
cargo build

# Release build (optimized for size)
cargo build --release

# Run tests
cargo test

Architecture

The project is organized into modular components:

• apps/ - Application integrations (Warp, iTerm2, VS Code, WezTerm, Cursor, Windsurf) and installer
• cache/ - Performance caching system (repository metadata, git status)
• git/ - Git operations (clone, search, status) and provider integrations
• mcp/ - Model Context Protocol server for AI integration
• ui/ - Terminal UI components (prompts, menus, workflows, smart actions)
• uri/ - URI scheme handling for deep linking
• utils/ - Shared utilities (filesystem, git, platform detection)
• workspace/ - Core workspace management (config, discovery, operations)

Contributing

Contributions are welcome! Please read our Contributing Guidelines and Code of Conduct before submitting PRs.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Special thanks to Anthropic for their groundbreaking work with Claude Code, making agentic coding so powerful and accessible. Many of the best practices from Claude Code Best Practices have influenced the design and philosophy of vibe-workspace.

Built with:

• Clap - Command line argument parsing
• Inquire - Interactive prompts
• git2 - Git operations
• Tokio - Async runtime

---

Start vibe-coding today and transform how your team builds software!

Made with ❤️ by Toolprint