{"id":30717874,"url":"https://github.com/commands-com/claude-stacks","last_synced_at":"2025-09-03T09:04:23.301Z","repository":{"id":312558188,"uuid":"1043037490","full_name":"Commands-com/claude-stacks","owner":"Commands-com","description":"Import/Export your Claude mcps/agents/commands/hooks/settings in seconds","archived":false,"fork":false,"pushed_at":"2025-08-31T13:23:32.000Z","size":17167,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-31T15:28:04.381Z","etag":null,"topics":["claude","claude-ai","claude-code","claudecode","cli","cli-tool"],"latest_commit_sha":null,"homepage":"https://commands.com","language":"TypeScript","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/Commands-com.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":"2025-08-23T02:49:04.000Z","updated_at":"2025-08-31T13:23:35.000Z","dependencies_parsed_at":"2025-08-31T15:38:25.085Z","dependency_job_id":null,"html_url":"https://github.com/Commands-com/claude-stacks","commit_stats":null,"previous_names":["commands-com/claude-stacks"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/Commands-com/claude-stacks","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Commands-com%2Fclaude-stacks","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Commands-com%2Fclaude-stacks/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Commands-com%2Fclaude-stacks/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Commands-com%2Fclaude-stacks/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Commands-com","download_url":"https://codeload.github.com/Commands-com/claude-stacks/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Commands-com%2Fclaude-stacks/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273417342,"owners_count":25101817,"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-09-03T02:00:09.631Z","response_time":76,"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":["claude","claude-ai","claude-code","claudecode","cli","cli-tool"],"created_at":"2025-09-03T09:02:22.209Z","updated_at":"2025-09-03T09:04:23.288Z","avatar_url":"https://github.com/Commands-com.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Claude Stacks\n\n![Coverage](https://img.shields.io/badge/coverage-90%25-brightgreen)\n[![npm version](https://badge.fury.io/js/claude-stacks.svg)](https://www.npmjs.com/package/claude-stacks)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nShare your Claude Code environment in seconds - export and import development stacks.\n\n## What is Claude Stacks?\n\nClaude Stacks is a CLI tool that allows you to:\n\n- **Export** your Claude Code environment configurations as portable stack files\n- **Share** development stacks with your team or the community via Commands.com\n- **Import** environments quickly across different projects and machines\n- **Browse** and install stacks from the Commands.com marketplace\n\nPerfect for sharing MCP server configurations, project setups, and development environments with Claude Code users.\n\n## Installation\n\nInstall globally via npm:\n\n```bash\nnpm install -g claude-stacks\n```\n\nOr use npx to run without installing:\n\n```bash\nnpx claude-stacks --help\n```\n\n## Quick Start\n\n### Export Your Current Setup\n\n```bash\nclaude-stacks export\n```\n\n### List Your Stacks\n\n```bash\nclaude-stacks list\n```\n\n### Export with Custom Metadata\n\n```bash\nclaude-stacks export --name \"My Dev Stack\" --description \"Full-stack development environment\"\n```\n\n### Import from a Stack\n\n```bash\nclaude-stacks import my-stack.json\n```\n\n### Share via Commands.com\n\n```bash\n# Publish to the marketplace\nclaude-stacks publish my-stack.json\n\n# Browse available stacks\nclaude-stacks browse\n\n# Install from marketplace\nclaude-stacks install org-name/stack-name\n```\n\n## Commands\n\n### Core Commands\n\n- **`export [filename]`** - Export current environment to a stack file\n- **`import \u003cfilename\u003e`** - Import environment from a stack file\n- **`publish \u003cfilename\u003e`** - Publish stack to Commands.com marketplace\n- **`install \u003cstack-id\u003e`** - Install stack from Commands.com\n- **`browse`** - Browse marketplace stacks interactively\n\n### Management Commands\n\n- **`list`** - List local stacks\n- **`scan-hooks`** - Scan hooks for potential security issues\n- **`delete \u003cstack-id\u003e`** - Delete published stack from Commands.com\n- **`rename \u003cstack-id\u003e`** - Rename published stack\n- **`clean`** - Clean up local stack metadata\n\n### Export Options\n\n- `--name \u003cname\u003e` - Custom stack name\n- `--description \u003cdescription\u003e` - Stack description\n- `--stack-version \u003cversion\u003e` - Set version (default: auto-increment)\n- `--include-global` - Include global `~/.claude` configurations\n- `--include-claude-md` - Include `CLAUDE.md` files\n\n### Import Options\n\n- `--overwrite` - Overwrite existing files (default: merge)\n- `--global-only` - Only import to global `~/.claude`\n\n## What Gets Exported?\n\nClaude Stacks captures your Claude Code environment including:\n\n- **MCP Server Configurations** - All configured MCP servers and their settings\n- **Project Commands** - Custom commands defined for your project\n- **Agent Configurations** - Custom agents and their configurations\n- **Hook Scripts** - User hook scripts with security analysis\n- **Project Settings** - Claude Code project-specific settings\n- **CLAUDE.md Files** - Project instructions (when `--include-claude-md` is used)\n- **Global Configurations** - User-level settings (when `--include-global` is used)\n\n## Hook Safety\n\nClaude Stacks automatically analyzes hook scripts for potential security risks during export:\n\n```bash\n# Scan hooks independently\nclaude-stacks scan-hooks\n\n# Security analysis is included during export\nclaude-stacks export my-stack.json\n```\n\n**Risk Levels:**\n\n- 🔴 **High** - Dangerous operations (command execution, file deletion)\n- 🟡 **Medium** - Potentially risky operations (network requests, file writes)\n- 🟢 **Low** - Minor concerns (environment variable access)\n\nSupports Python, JavaScript, TypeScript, and Bash hook analysis.\n\n\u003e **⚠️ Important:** Hook analysis provides guidance only. Users install and execute hooks at their own risk. Always review hook code before use, especially from untrusted sources.\n\n## Authentication\n\nTo publish or manage stacks on Commands.com, you'll need to authenticate:\n\n```bash\nclaude-stacks publish my-stack.json\n```\n\nThe CLI will automatically guide you through the OAuth authentication process on first use.\n\n## Stack File Format\n\nStack files are JSON documents containing:\n\n```json\n{\n  \"name\": \"My Development Stack\",\n  \"description\": \"Full-stack development environment with MCP servers\",\n  \"version\": \"1.0.0\",\n  \"author\": \"Your Name\",\n  \"mcpServers\": [...],\n  \"commands\": [...],\n  \"agents\": [...],\n  \"settings\": {...}\n}\n```\n\n## Development\n\n### Prerequisites\n\n- Node.js 18+\n- npm or yarn\n\n### Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/commands-com/claude-stacks.git\ncd claude-stacks\n\n# Install dependencies\nnpm install\n\n# Build the project\nnpm run build\n\n# Run tests\nnpm test\n```\n\n### Development Scripts\n\n- `npm run dev` - Run in development mode\n- `npm run build` - Build TypeScript to JavaScript\n- `npm run test` - Run test suite with coverage\n- `npm run lint` - Lint code\n- `npm run format` - Format code with Prettier\n- `npm run quality` - Run all quality checks\n\n### Testing\n\nThe project has comprehensive test coverage (90%+):\n\n```bash\n# Run all tests\nnpm test\n\n# Run specific test types\nnpm run test:unit\nnpm run test:integration\nnpm run test:e2e\n\n# Watch mode during development\nnpm run test:watch\n```\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Make your changes\n4. Run quality checks (`npm run quality`)\n5. Commit your changes (`git commit -m 'Add amazing feature'`)\n6. Push to the branch (`git push origin feature/amazing-feature`)\n7. Open a Pull Request\n\n## Security\n\nThis tool handles your Claude Code configurations and requires network access to Commands.com. All data transmission is encrypted and the tool follows security best practices:\n\n- OAuth 2.0 PKCE for secure authentication\n- HTTPS-only API communication\n- Local credential storage with appropriate permissions\n- Input validation and sanitization\n- Automated security analysis of hook scripts\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## Support\n\n- [GitHub Issues](https://github.com/commands-com/claude-stacks/issues) - Bug reports and feature requests\n- [Commands.com](https://commands.com) - Browse and share stacks\n\n---\n\nMade with ❤️ for the Claude Code community\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcommands-com%2Fclaude-stacks","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcommands-com%2Fclaude-stacks","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcommands-com%2Fclaude-stacks/lists"}