{"id":49944527,"url":"https://github.com/shiftinbits/constellation-claude","last_synced_at":"2026-05-17T14:07:22.041Z","repository":{"id":351127036,"uuid":"1122830354","full_name":"ShiftinBits/constellation-claude","owner":"ShiftinBits","description":"Codebase Understanding for Claude Code","archived":false,"fork":false,"pushed_at":"2026-05-01T05:16:40.000Z","size":80,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-01T07:17:47.382Z","etag":null,"topics":["agentic-ai","agentic-ai-development","ai","ai-driven-development","claude","claude-code","claude-code-plugin","claude-code-skills","code","code-analysis","mcp","software-development"],"latest_commit_sha":null,"homepage":"https://docs.constellationdev.io/plugins/claude-code/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ShiftinBits.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":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-12-25T15:55:17.000Z","updated_at":"2026-05-01T05:16:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ShiftinBits/constellation-claude","commit_stats":null,"previous_names":["shiftinbits/constellation-claude"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ShiftinBits/constellation-claude","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ShiftinBits%2Fconstellation-claude","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ShiftinBits%2Fconstellation-claude/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ShiftinBits%2Fconstellation-claude/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ShiftinBits%2Fconstellation-claude/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ShiftinBits","download_url":"https://codeload.github.com/ShiftinBits/constellation-claude/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ShiftinBits%2Fconstellation-claude/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33141437,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-17T09:28:26.183Z","status":"ssl_error","status_checked_at":"2026-05-17T09:27:52.702Z","response_time":107,"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":["agentic-ai","agentic-ai-development","ai","ai-driven-development","claude","claude-code","claude-code-plugin","claude-code-skills","code","code-analysis","mcp","software-development"],"created_at":"2026-05-17T14:07:20.542Z","updated_at":"2026-05-17T14:07:22.029Z","avatar_url":"https://github.com/ShiftinBits.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cimg src=\"https://constellationdev.io/clawd-icon.svg\" height=\"30\"\u003e Constellation Plugin for Claude Code\n\n[![MCP Server](https://img.shields.io/badge/mcp-@constellationdev/mcp-black.svg?logo=modelcontextprotocol)](https://github.com/ShiftinBits/constellation-mcp) [![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-3DA639?logo=opensourceinitiative\u0026logoColor=white)](LICENSE)\n\nWhile Constellation's MCP server provides raw code intelligence capabilities, this plugin enhances your Claude Code experience with:\n\n| Feature | Benefit |\n|---------|---------|\n| **Slash Commands** | Quick access to common workflows |\n| **Contextual Skills** | Claude automatically loads relevant knowledge — including proactive impact analysis before risky changes |\n| **Safety Hooks** | Nudges Claude toward `code_intel` over text search at session start, in subagents, and before Grep/Glob/Bash search commands |\n\n## Features\n\n### Commands\n\nExecute powerful analysis with simple slash commands:\n\n| Command | Description |\n|---------|-------------|\n| `/constellation:status` | Check API connectivity and project indexing status |\n| `/constellation:diagnose` | Quick health check for connectivity and authentication |\n| `/constellation:impact \u003csymbol\u003e \u003cfile\u003e` | Analyze blast radius before changing a symbol |\n| `/constellation:deps \u003cfile\u003e [--reverse]` | Map dependencies or find what depends on a file |\n| `/constellation:unused` | Discover orphaned exports and dead code |\n| `/constellation:architecture` | Get a high-level overview of your codebase structure |\n\n### Skills\n\nClaude automatically activates specialized knowledge based on your questions:\n\n| Skill | Triggers When You Ask About... |\n|-------|-------------------------------|\n| **constellation-troubleshooting** | Error codes, connectivity issues, debugging problems |\n| **impact-analysis** | Renaming, refactoring, deleting, or moving symbols/files; \"what would break if...\", \"is X dead code\", \"what depends on X\" |\n\n**Example Trigger:**\n```\nYou: \"Rename AuthService to AuthenticationService\"\nClaude: \"Before renaming, let me analyze the potential impact...\"\n[impact-analysis skill activates, runs api.impactAnalysis, reports risk + dependents]\n```\n\n### Hooks\n\nEvent hooks enable intelligent, transparent assistance:\n\n| Hook | Event (matcher) | Behavior |\n|------|-----------------|----------|\n| **Session Awareness** | `SessionStart` | Injects `code_intel` MCP tool awareness at session start |\n| **Subagent Awareness** | `SubagentStart` | Injects `code_intel` awareness into spawned subagents (built-ins like Explore/Plan don't inherit project AGENTS.md) |\n| **Search Tool Nudge** | `PreToolUse` (`Grep\\|Glob`) | Reminds Claude to prefer `code_intel` over Grep/Glob for structural queries |\n| **Bash Search Nudge** | `PreToolUse` (`Bash`) | Inspects the command and emits the same reminder when it starts with `grep`/`rg`/`glob`/`awk`/`findstr` |\n\nAll hooks are gated on `CONSTELLATION_ACCESS_KEY` being set (no key → silent no-op, so the plugin doesn't nag in environments where Constellation isn't configured).\n\n## Installation\n\n### Prerequisites\n\n1. **Constellation Account** (see [Constellation](https://app.constellationdev.io))\n2. **Project indexed** in Constellation\n3. **Access key** configured\n\n### Quick Start\n\n```bash\n# Add the marketplace to Claude\nclaude plugin marketplace add ShiftinBits/constellation-claude\n\n# Install the Constellation Claude plugin\nclaude plugin install constellation@constellation-plugins\n```\n\n## Usage Examples\n\n### Check Your Setup\n\n```\n\u003e /constellation:status\n\nStatus: Connected\nProject: my-awesome-app\nFiles Indexed: 1,247\nSymbols: 8,932\nLanguages: TypeScript, JavaScript\n```\n\n### Analyze Before Refactoring\n\n```\n\u003e /constellation:impact validateUser src/auth/validator.ts\n\nSymbol: validateUser (function)\nRisk Level: MEDIUM\nFiles Affected: 12\nSymbols Affected: 34\nTest Coverage: 67%\n\nRecommendations:\n- Update unit tests in auth.spec.ts\n- Check integration with UserController\n```\n\n### Find Dead Code\n\n```\n\u003e /constellation:unused --kind function\n\nFound 7 orphaned functions:\n├── src/utils/legacy.ts\n│   ├── formatLegacyDate (line 23)\n│   └── parseLegacyConfig (line 45)\n├── src/helpers/deprecated.ts\n│   └── oldValidation (line 12)\n...\n```\n\n### Understand Dependencies\n\n```\n\u003e /constellation:deps src/services/payment.service.ts\n\nDependencies (12):\n├── Internal (8)\n│   ├── src/models/payment.model.ts\n│   ├── src/utils/currency.ts\n│   └── ...\n└── External (4)\n    ├── stripe\n    ├── lodash\n    └── ...\n\nNo circular dependencies detected.\n```\n\n## Troubleshooting\n\n### Common Issues\n\n| Issue | Solution |\n|-------|----------|\n| `AUTH_ERROR` | Check `CONSTELLATION_ACCESS_KEY` is set correctly, use `constellation auth` CLI command to set |\n| `PROJECT_NOT_INDEXED` | Run `constellation index --full` in your project |\n| Commands not appearing | Restart Claude Code or check plugin path |\n\n## Documentation\n\n- [Constellation Documentation](https://docs.constellationdev.io) — Full platform documentation\n- [MCP Server](https://github.com/shiftinbits/constellation-mcp) — Underlying MCP server\n- [Claude Code Plugins](https://docs.anthropic.com/claude-code/plugins) — Plugin development guide\n\n## License\n\nGNU Affero General Public License v3.0 (AGPL-3.0)\n\nCopyright © 2026 ShiftinBits Inc.\n\nSee [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshiftinbits%2Fconstellation-claude","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshiftinbits%2Fconstellation-claude","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshiftinbits%2Fconstellation-claude/lists"}