https://github.com/existential-birds/beagle
Claude Code plugin for code review skills and verification workflows. Python, Go, React, FastAPI, BubbleTea, and AI frameworks (Pydantic AI, LangGraph, Vercel AI SDK).
https://github.com/existential-birds/beagle
ai-agents bubbletea claude-code claude-code-plugin code-review developer-tools elixir fastapi golang langgraph llm-tools phoenix pydantic-ai python react typescript
Last synced: 3 days ago
JSON representation
Claude Code plugin for code review skills and verification workflows. Python, Go, React, FastAPI, BubbleTea, and AI frameworks (Pydantic AI, LangGraph, Vercel AI SDK).
- Host: GitHub
- URL: https://github.com/existential-birds/beagle
- Owner: existential-birds
- License: apache-2.0
- Created: 2025-12-21T15:44:12.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-02-10T08:34:20.000Z (6 days ago)
- Last Synced: 2026-02-10T13:39:46.143Z (6 days ago)
- Topics: ai-agents, bubbletea, claude-code, claude-code-plugin, code-review, developer-tools, elixir, fastapi, golang, langgraph, llm-tools, phoenix, pydantic-ai, python, react, typescript
- Language: Python
- Homepage: https://existentialbirds.com
- Size: 983 KB
- Stars: 21
- Watchers: 2
- Forks: 2
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# beagle
[](https://deepwiki.com/existential-birds/beagle)
> **Upgrading from beagle v1?** The monolithic `beagle` plugin was split into individual plugins in v2.0.0. If you still have `beagle@existential-birds` enabled in `~/.claude/settings.json`, it now loads as a no-op stub. You can remove it with:
> ```
> claude plugin uninstall beagle@existential-birds
> ```
> Then install the individual plugins you need (see [Installation](#installation) below).
*Image: NASA, Public Domain. [Source](https://www.nasa.gov/multimedia/imagegallery/image_feature_572.html)*
A Claude Code plugin marketplace for code review and verification workflows. Catch issues before you push with pre-commit reviews for Python, Go, Elixir, React, iOS/Swift, and AI frameworks.
Powers the agents in [Amelia](https://github.com/existential-birds/amelia). For automated review-fix-test loops, see [Daydream](https://github.com/existential-birds/daydream).
## Installation
**Prerequisites:**
- [Claude Code](https://claude.ai/code) CLI installed
- [agent-browser](https://github.com/vercel-labs/agent-browser) for `run-test-plan` command (optional)
```bash
# Add the marketplace
claude plugin marketplace add https://github.com/existential-birds/beagle
# Install the plugins you need
claude plugin install beagle-core@existential-birds
claude plugin install beagle-python@existential-birds
claude plugin install beagle-react@existential-birds
```
Verify installation by running `/:` in Claude Code (e.g., `/beagle-core:`)—you should see the command list.
To update: `claude plugin marketplace update existential-birds && claude plugin update `
**Troubleshooting:**
- "Marketplace file not found": Remove stale entries from `~/.claude/plugins/known_marketplaces.json` and restart Claude Code.
- Plugin not updating: Run `claude plugin marketplace update existential-birds` to refresh the marketplace.
### Other Agents
Use the [skills CLI](https://skills.sh/docs/cli) to install beagle skills for other AI agents:
```bash
npx skills add existential-birds/beagle
```
This downloads the skills and configures them for your agent. Commands are Claude Code specific and not available through the skills CLI.
## Plugins
| Plugin | Skills | Commands | Category |
|--------|--------|----------|----------|
| **beagle-core** | 8 | 11 | Shared workflows, verification, git |
| **beagle-python** | 6 | 1 | Python, FastAPI, SQLAlchemy, pytest |
| **beagle-go** | 6 | 2 | Go, BubbleTea, Wish SSH, Prometheus |
| **beagle-elixir** | 10 | 1 | Elixir, Phoenix, LiveView, ExUnit, ExDoc |
| **beagle-ios** | 12 | 1 | Swift, SwiftUI, SwiftData, iOS frameworks |
| **beagle-react** | 15 | 1 | React, React Flow, shadcn/ui, Tailwind |
| **beagle-ai** | 13 | 0 | Pydantic AI, LangGraph, DeepAgents |
| **beagle-docs** | 7 | 5 | Documentation quality, AI writing detection (Diataxis) |
| **beagle-analysis** | 5 | 3 | 12-Factor, ADRs, LLM-as-judge |
| **beagle-testing** | 0 | 2 | Test plan generation and execution |
| **Total** | **82** | **27** | |
## Commands
Run with `/:`. See [Slash commands](https://docs.claude.com/en/docs/claude-code/slash-commands).
### beagle-core
| Command | Description |
|---------|-------------|
| `review-plan ` | Review implementation plans |
| `review-llm-artifacts` | Detect LLM coding artifacts |
| `fix-llm-artifacts` | Fix detected artifacts |
| `commit-push` | Commit and push changes |
| `create-pr` | Create PR with template |
| `gen-release-notes ` | Generate release notes |
| `receive-feedback ` | Process review feedback |
| `fetch-pr-feedback` | Fetch bot comments from PR |
| `respond-pr-feedback` | Reply to bot comments |
| `skill-builder` | Create new skills |
| `prompt-improver` | Optimize prompts |
### Code Review
| Command | Plugin | Description |
|---------|--------|-------------|
| `review-python` | beagle-python | Python/FastAPI code review |
| `review-frontend` | beagle-react | React/TypeScript code review |
| `review-go` | beagle-go | Go code review |
| `review-tui` | beagle-go | BubbleTea TUI code review |
| `review-ios` | beagle-ios | iOS/SwiftUI code review |
| `review-elixir` | beagle-elixir | Elixir/Phoenix code review |
### Documentation & Analysis
| Command | Plugin | Description |
|---------|--------|-------------|
| `draft-docs ` | beagle-docs | Generate documentation drafts |
| `improve-doc ` | beagle-docs | Improve docs using Diataxis |
| `ensure-docs` | beagle-docs | Documentation coverage check |
| `review-ai-writing` | beagle-docs | Detect AI writing patterns |
| `humanize` | beagle-docs | Fix AI writing with safe/risky classification |
| `12-factor-apps-analysis` | beagle-analysis | 12-Factor compliance check |
| `llm-judge` | beagle-analysis | Compare implementations |
| `write-adr` | beagle-analysis | Generate ADRs from decisions |
### Testing
| Command | Plugin | Description |
|---------|--------|-------------|
| `gen-test-plan` | beagle-testing | Generate YAML test plan |
| `run-test-plan` | beagle-testing | Execute test plan |