{"id":47733439,"url":"https://github.com/mcs-cli/mcs","last_synced_at":"2026-04-29T01:09:34.170Z","repository":{"id":338342158,"uuid":"1157522299","full_name":"mcs-cli/mcs","owner":"mcs-cli","description":"Managed Claude Stack - Reproducible AI infrastructure for Claude Code","archived":false,"fork":false,"pushed_at":"2026-04-01T20:19:51.000Z","size":1345,"stargazers_count":86,"open_issues_count":18,"forks_count":7,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-04-02T07:52:14.183Z","etag":null,"topics":["agent","agentic-ai","claude-code","convergence","portability","reproducibility"],"latest_commit_sha":null,"homepage":"https://mcs-cli.dev","language":"Swift","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/mcs-cli.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-13T23:11:37.000Z","updated_at":"2026-04-01T20:19:55.000Z","dependencies_parsed_at":"2026-03-04T03:06:15.282Z","dependency_job_id":null,"html_url":"https://github.com/mcs-cli/mcs","commit_stats":null,"previous_names":["bguidolim/my-claude-ios-setup","bguidolim/myclaudesetup","bguidolim/mcs"],"tags_count":24,"template":false,"template_full_name":null,"purl":"pkg:github/mcs-cli/mcs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcs-cli%2Fmcs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcs-cli%2Fmcs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcs-cli%2Fmcs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcs-cli%2Fmcs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mcs-cli","download_url":"https://codeload.github.com/mcs-cli/mcs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcs-cli%2Fmcs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31317831,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T21:35:00.834Z","status":"ssl_error","status_checked_at":"2026-04-02T21:34:59.806Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["agent","agentic-ai","claude-code","convergence","portability","reproducibility"],"created_at":"2026-04-02T22:02:16.246Z","updated_at":"2026-04-02T22:02:20.118Z","avatar_url":"https://github.com/mcs-cli.png","language":"Swift","funding_links":["https://github.com/sponsors/bguidolim"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://mcs-cli.dev/assets/logo.svg\"\u003e\n  \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://mcs-cli.dev/assets/logo-light.svg\"\u003e\n  \u003cimg alt=\"mcs\" src=\"https://mcs-cli.dev/assets/logo-light.svg\" width=\"280\"\u003e\n\u003c/picture\u003e\n\n### Your Claude Code environment — packaged, portable, and reproducible.\n\n[![Swift 6.0+](https://img.shields.io/badge/Swift-6.0+-F05138.svg?logo=swift\u0026logoColor=white)](https://swift.org)\n[![macOS](https://img.shields.io/badge/macOS-13+-000000.svg?logo=apple\u0026logoColor=white)](https://www.apple.com/macos/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Homebrew](https://img.shields.io/badge/Homebrew-tap-FBB040.svg?logo=homebrew\u0026logoColor=white)](https://github.com/mcs-cli/homebrew-tap)\n[![Tech Packs](https://img.shields.io/badge/Tech_Packs-Browse-8B5CF6.svg)](https://techpacks.mcs-cli.dev)\n[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/mcs-cli/mcs)\n\n\u003c/div\u003e\n\n## 🚀 Quick Start\n\n### 1. Install\n\n```bash\nbrew install mcs-cli/tap/mcs\n```\n\n### 2. Add tech packs\n\nBrowse available packs at **[techpacks.mcs-cli.dev](https://techpacks.mcs-cli.dev)**, then add them:\n\n```bash\nmcs pack add owner/pack-name\n```\n\n### 3. Sync a project\n\n```bash\ncd ~/Developer/my-project\nmcs sync\n```\n\n### 4. Verify everything\n\n```bash\nmcs doctor\n```\n\nThat's it. Your MCP servers, plugins, hooks, skills, commands, agents, settings, and templates are all in place.\n\n---\n\n## The Problem\n\nYou've spent hours getting Claude Code just right — MCP servers, plugins, hooks, skills, custom commands, fine-tuned settings. Then:\n\n- 🖥️ **New machine?** Start over from scratch.\n- 👥 **Onboarding a teammate?** \"Just follow this 47-step wiki page.\"\n- 📂 **Different projects?** Copy-paste configs, hope nothing drifts.\n- 🔄 **Something broke?** Good luck figuring out what changed.\n\n## The Solution\n\n`mcs` is a **configuration engine for Claude Code** — like Ansible for your AI development environment. Package everything into shareable **tech packs** (Git repos with a `techpack.yaml` manifest), then sync them across any project, any machine, in seconds.\n\n| Without `mcs` | With `mcs` |\n|---|---|\n| Install MCP servers one by one | `mcs pack add` + `mcs sync` |\n| Hand-edit `settings.json` per project | Managed settings composition |\n| Copy hooks between projects manually | Auto-installed per-project from packs |\n| Configuration drifts silently | `mcs doctor --fix` detects and repairs |\n| Rebuild from memory on new machines | Fully reproducible in minutes |\n| No way to share your setup | Push a pack, anyone can `mcs pack add` it |\n\n---\n\n## 🔍 Explore Tech Packs\n\nPacks are modular — mix and match what you need instead of one monolith. Browse the full catalog, search by category, and find install commands:\n\n**[techpacks.mcs-cli.dev](https://techpacks.mcs-cli.dev)**\n\n\u003e 💡 Can't find what you need? Build your own — see [Creating Tech Packs](docs/creating-tech-packs.md).\n\n---\n\n## ⚙️ How It Works\n\n```\n Tech Packs          mcs sync          Your Project\n (Git repos)  -----\u003e (engine)  -----\u003e (configured)\n                        |\n                   .---------.\n                   |         |\n                   v         v\n              Per-Project  Global\n              artifacts    artifacts\n```\n\n1. **Select** which packs to apply (interactive multi-select or `--all`)\n2. **Resolve** prompts (auto-detect project files, ask for config values)\n3. **Install** artifacts to the right locations (skills, hooks, commands, agents, settings, MCP servers)\n4. **Track** everything for convergence — re-running `mcs sync` adds what's missing, removes what's deselected, and updates what changed\n\nUse `mcs sync --global` for global-scope components (Homebrew packages, plugins, global MCP servers). See [Architecture](docs/architecture.md) for artifact locations and the full sync flow.\n\n---\n\n## 📦 What's in a Tech Pack?\n\nA tech pack is a Git repo with a `techpack.yaml` manifest. It can bundle MCP servers, plugins, hooks, skills, commands, agents, settings, templates, and doctor checks — anything `mcs` can install, verify, and uninstall.\n\nUse `mcs pack validate` to check your pack for structural errors and best practices before sharing.\n\n📖 **Full guide:** [Creating Tech Packs](docs/creating-tech-packs.md) · **Schema reference:** [techpack-schema.md](docs/techpack-schema.md)\n\n---\n\n## 🎯 Use Cases\n\n- **🧑‍💻 Solo Developer** — New Mac? One `mcs pack add` + `mcs sync` and your entire Claude Code environment is back. No wiki, no notes, no memory required.\n- **👥 Teams** — Create a team pack with your org's MCP servers, approved plugins, and coding standards. Every developer gets the same setup with `mcs sync --all`.\n- **🌐 Open Source** — Use `mcs export` to create a tech pack from your repo's config. Contributors run `mcs sync` and get the right MCP servers, skills, and conventions automatically.\n- **🧪 Experimentation** — Try a different set of MCP servers, swap packs, roll back. `mcs` converges cleanly — deselected packs are fully removed, no leftovers.\n\n---\n\n## 🛡️ Safety \u0026 Trust\n\n`mcs` is designed to be non-destructive and transparent. Timestamped backups before modifying user content, `--dry-run` to preview changes, section markers to preserve your edits in `CLAUDE.local.md`, and SHA-256 trust verification for pack scripts. Lockfiles (`mcs.lock.yaml`) pin pack versions for reproducible environments.\n\n📖 **Full details:** [Architecture \u003e Safety \u0026 Trust](docs/architecture.md#safety--trust)\n\n---\n\n## 🔍 Verifying Your Setup with Poirot\n\nAfter `mcs sync`, want to confirm everything landed correctly? [**Poirot**](https://github.com/leonardocardoso/poirot) is a native macOS companion that gives you a visual overview of your Claude Code configuration — MCP servers, settings, sessions, and more — all in one place.\n\nThe perfect complement to `mcs`: configure your environment with `mcs`, then use Poirot to see exactly what's installed and running.\n\n---\n\n## 📚 Documentation\n\n| Document | Description |\n|----------|-------------|\n| 📖 [CLI Reference](docs/cli.md) | Complete command reference (`sync`, `pack`, `doctor`, `export`, `cleanup`, `check-updates`, `config`) |\n| 📖 [Creating Tech Packs](docs/creating-tech-packs.md) | Step-by-step guide to building your first pack |\n| 📋 [Tech Pack Schema](docs/techpack-schema.md) | Complete `techpack.yaml` field reference |\n| 🏗️ [Architecture](docs/architecture.md) | Internal design, sync flow, safety guarantees, and extension points |\n| 🔧 [Troubleshooting](docs/troubleshooting.md) | Common issues and fixes |\n\n---\n\n## 🛠️ Development\n\n```bash\nswift build                                            # Build\nswift test                                             # Run tests\nswift build -c release --arch arm64 --arch x86_64      # Universal binary\n```\n\nSee [Architecture](docs/architecture.md) for project structure and design decisions.\n\n## 🤝 Contributing\n\nTech pack ideas and engine improvements are welcome!\n\n1. Fork the repo\n2. Create a feature branch\n3. Run `swift test`\n4. Open a PR\n\nFor building new packs, start with [Creating Tech Packs](docs/creating-tech-packs.md).\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n## 💛 Support\n\nIf `mcs` saves you time, consider [sponsoring the project](https://github.com/sponsors/bguidolim).\n\n**MIT License** · Made with ❤️ by [Bruno Guidolim](https://github.com/bguidolim) · [mcs-cli](https://github.com/mcs-cli)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmcs-cli%2Fmcs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmcs-cli%2Fmcs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmcs-cli%2Fmcs/lists"}