Skip to content

existential-birds/beagle

Repository files navigation

beagle

Ask DeepWiki

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 below).

Apollo 10 astronaut Thomas P. Stafford pats the nose of a stuffed Snoopy

Image: NASA, Public Domain. Source

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. For automated review-fix-test loops, see Daydream.

Installation

Prerequisites:

# 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 /<plugin-name>: in Claude Code (e.g., /beagle-core:)—you should see the command list.

To update: claude plugin marketplace update existential-birds && claude plugin update <plugin-name>

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 to install beagle skills for other AI agents:

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 /<plugin-name>:<command>. See Slash commands.

beagle-core

Command Description
review-plan <path> 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 <tag> Generate release notes
receive-feedback <path> 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 <prompt> beagle-docs Generate documentation drafts
improve-doc <path> 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