{"id":31810896,"url":"https://github.com/toolprint/vibe-workspace","last_synced_at":"2025-10-11T06:17:36.948Z","repository":{"id":307885846,"uuid":"1025908266","full_name":"toolprint/vibe-workspace","owner":"toolprint","description":"Manage a vibe workspace with many repos","archived":false,"fork":false,"pushed_at":"2025-08-24T23:24:43.000Z","size":981,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-25T02:08:04.402Z","etag":null,"topics":["agents","background-agent","claude-code","developer-tools","development-environment","llm","mcp","mcp-server","terminal","vibe-coding"],"latest_commit_sha":null,"homepage":"https://toolprint.ai/","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/toolprint.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-25T02:31:31.000Z","updated_at":"2025-08-21T21:56:46.000Z","dependencies_parsed_at":"2025-08-02T21:31:39.144Z","dependency_job_id":"fca1aeee-4149-4dda-80cc-188bd70b38fb","html_url":"https://github.com/toolprint/vibe-workspace","commit_stats":null,"previous_names":["toolprint/vibe-workspace"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/toolprint/vibe-workspace","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toolprint%2Fvibe-workspace","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toolprint%2Fvibe-workspace/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toolprint%2Fvibe-workspace/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toolprint%2Fvibe-workspace/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/toolprint","download_url":"https://codeload.github.com/toolprint/vibe-workspace/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toolprint%2Fvibe-workspace/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279006450,"owners_count":26084107,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-11T02:00:06.511Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","background-agent","claude-code","developer-tools","development-environment","llm","mcp","mcp-server","terminal","vibe-coding"],"created_at":"2025-10-11T06:17:29.556Z","updated_at":"2025-10-11T06:17:36.940Z","avatar_url":"https://github.com/toolprint.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vibe Workspace\n\n[![MCP](https://badge.mcpx.dev?type=server\u0026features=resources,tools)](https://modelcontextprotocol.io/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![MSRV](https://img.shields.io/badge/rust-1.88.0%2B-orange.svg)](https://forge.rust-lang.org/releases.html)\n[![Cargo](https://img.shields.io/crates/v/vibe-workspace.svg)](https://crates.io/crates/vibe-workspace)\n[![Downloads](https://img.shields.io/crates/d/vibe-workspace.svg)](https://crates.io/crates/vibe-workspace)\n\nA lightweight CLI tool designed to help developers quickly adopt vibe-coding patterns across multiple repositories.\n\nVibe Workspace streamlines your development workflow by providing consistent environments, tooling configurations, and coding patterns for modern AI Agentic coding.\n\n## Features\n\n- 🚀 **Instant Setup** - Get productive in seconds with pre-configured vibe patterns\n- 🎯 **Pattern Enforcement** - Consistent coding patterns across all your repositories\n- 📁 **Multi-Repository Management** - Orchestrate vibe patterns across entire organizations\n- 🆕 **Quick Prototyping** - Create new repositories instantly with `vibe create`\n- 🔧 **Developer Tool Integration** - Pre-configured Warp, iTerm2, WezTerm, VS Code, Cursor, and Windsurf templates\n- 🎨 **Vibe Templates** - Ready-to-use configurations for different tech stacks\n- 🔄 **Pattern Propagation** - Apply vibe patterns to new and existing repositories\n- 📱 **Menu Mode** - Guided setup for vibe-coding workflows\n- 🤖 **MCP Support** - Model Context Protocol server for AI integration\n- 🛠️ **Extensible** - Create custom vibe patterns for your team\n\n## Platform Support\n\nCurrently, **macOS is the only officially tested and supported platform**, with universal binaries available for both arm64 and amd64 architectures.\n\nWe 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.\n\n## Installation\n\n### Recommended (macOS)\n\nFor the fastest installation on macOS, first ensure you have `cargo-binstall`:\n\n```bash\nbrew install cargo-binstall\n```\n\nThen install vibe-workspace:\n\n```bash\ncargo binstall vibe-workspace\n```\n\n### From Cargo (Build from Source)\n\n```bash\ncargo install vibe-workspace\n```\n\n### From Source\n\n```bash\ngit clone https://github.com/toolprint/vibe-workspace\ncd vibe-workspace\ncargo install --path .\n```\n\n## Quick Start\n\nGet started with the interactive setup wizard:\n\n```bash\n# Run the setup wizard (recommended for first-time users)\nvibe setup\n\n# Or launch the interactive menu\nvibe\n```\n\nThe setup wizard will:\n\n1. **Discover repositories** in your workspace automatically\n2. **Check installed apps** (VS Code, Warp, iTerm2, WezTerm, Cursor, Windsurf)\n3. **Configure default app** for opening repositories\n\nAfter setup, use these essential commands:\n\n```bash\nvibe launch                # Interactive recent repository selector\nvibe create my-prototype   # Create new repository for prototyping  \nvibe clone \u003cgithub-url\u003e    # Clone, configure, and open in one command\nvibe                       # Interactive menu with smart actions\n```\n\nFor detailed getting started guide, see [Quick Start Guide](docs/QUICK_START.md).\n\n## Supported Applications\n\n- **[Warp Terminal](https://www.warp.dev/)** - Modern terminal with AI features and collaborative tools\n- **[iTerm2](https://iterm2.com/)** - Feature-rich terminal emulator for macOS\n- **[WezTerm](https://wezfurlong.org/wezterm/)** - GPU-accelerated cross-platform terminal\n- **[Visual Studio Code](https://code.visualstudio.com/)** - Popular code editor with extensive plugin ecosystem\n- **[Cursor](https://cursor.sh/)** - AI-first code editor with built-in AI assistance and chat\n- **[Windsurf](https://codeium.com/windsurf)** - Agentic IDE powered by AI Flow paradigm\n\nFor detailed app configuration, templates, and additional developer tools, see [App Integration Guide](docs/APPS.md).\n\n## Configuration\n\nVibe stores its configuration and data in `~/.toolprint/vibe-workspace/`:\n\n```\n~/.toolprint/vibe-workspace/\n├── config.yaml          # Main workspace configuration\n├── state.json           # User preferences and recent repositories\n├── templates/           # App-specific templates\n│   ├── warp/\n│   ├── iterm2/\n│   ├── wezterm/\n│   ├── vscode/\n│   ├── cursor/\n│   └── windsurf/\n├── cache/               # Performance caches\n│   ├── repositories.db  # Repository metadata cache\n│   └── git_status.db   # Git status cache\n└── backups/            # Configuration backups\n```\n\n**Key Configuration Files:**\n\n- `config.yaml` - Repository definitions, app settings, and workspace configuration\n- `state.json` - Recent repositories, user preferences, and setup completion status\n- `templates/` - Customizable templates for how apps open repositories\n\nUse these commands to manage configuration:\n\n```bash\nvibe config show           # View current configuration\nvibe config edit           # Edit configuration file\nvibe config backup         # Create backup archive\nvibe config reset          # Factory reset (with confirmation)\n```\n\n## MCP Integration\n\nvibe-workspace includes built-in MCP (Model Context Protocol) server capabilities for AI integration.\n\n### Claude Code Integration\n\nAfter installing the vibe-workspace binary on your system, you can add it to Claude Code with:\n\n```bash\nclaude mcp add -s user -t stdio vibe vibe mcp\n```\n\nFor detailed MCP configuration and capabilities, see [MCP Documentation](docs/MCP.md).\n\n## Development\n\n### Building\n\n```bash\n# Development build\ncargo build\n\n# Release build (optimized for size)\ncargo build --release\n\n# Run tests\ncargo test\n```\n\n### Architecture\n\nThe project is organized into modular components:\n\n- `apps/` - Application integrations (Warp, iTerm2, VS Code, WezTerm, Cursor, Windsurf) and installer\n- `cache/` - Performance caching system (repository metadata, git status)\n- `git/` - Git operations (clone, search, status) and provider integrations\n- `mcp/` - Model Context Protocol server for AI integration\n- `ui/` - Terminal UI components (prompts, menus, workflows, smart actions)\n- `uri/` - URI scheme handling for deep linking\n- `utils/` - Shared utilities (filesystem, git, platform detection)\n- `workspace/` - Core workspace management (config, discovery, operations)\n\n## Contributing\n\nContributions are welcome! Please read our [Contributing Guidelines](CONTRIBUTING.md) and [Code of Conduct](CODE_OF_CONDUCT.md) before submitting PRs.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\nSpecial 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](https://www.anthropic.com/engineering/claude-code-best-practices) have influenced the design and philosophy of vibe-workspace.\n\nBuilt with:\n\n- [Clap](https://github.com/clap-rs/clap) - Command line argument parsing\n- [Inquire](https://github.com/mikaelmello/inquire) - Interactive prompts\n- [git2](https://github.com/rust-lang/git2-rs) - Git operations\n- [Tokio](https://tokio.rs/) - Async runtime\n\n---\n\n**Start vibe-coding today and transform how your team builds software!**\n\nMade with ❤️ by [Toolprint](https://www.toolprint.ai/)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoolprint%2Fvibe-workspace","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftoolprint%2Fvibe-workspace","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoolprint%2Fvibe-workspace/lists"}