Documentation

Getting Started

@mention codemagpie on any GitHub issue or PR — it writes the code or reviews the diff.

Install & connect

Connected repos appear under Managed Repos in the dashboard, each with per-repo Auto-review and Auto-fix toggles and an optional Test command.

Required permissions:

Contents — read & write (to commit code)
Pull requests — read & write (to open and comment on PRs)
Issues — read & write (to read issue descriptions and post comments)

Generate code from an issue

On any GitHub issue, leave a comment with @codemagpieai create followed by what you want.

Issue comment

@codemagpieai create a dark mode toggle for the settings page

codemagpie acknowledges, then works the issue end to end:

Clones the repo on a fresh codemagpie/<run-id> branch
Reads, writes, and runs commands across the codebase to implement the change
Runs your Test command if one is set, and flags failures on the PR
Commits as codemagpie[bot], opens a pull request, and comments back with the link

Tips for better results

Describe the desired behavior, not the implementation
Link to relevant files or existing code if helpful
Mention constraints (e.g. "use Tailwind", "no new dependencies")

Language support

The agent runs in a Python environment, so Python is the only language it can fully verify — it runs the tests it touches and auto-fixes lint before opening the PR.

It can still write code in other languages (JavaScript/TypeScript, Go, etc.), but those changes are not built, linted, or tested before the PR is opened — review them carefully and rely on your own CI.

Review a pull request

On any pull request, mention @codemagpieai in a comment to request a code review.

PR comment

@codemagpieai please review this

codemagpie posts inline review comments directly on the diff. Turn on Auto-review for a repo to have every new pull request reviewed automatically — no mention needed.

Auto-fix on failure

Enable the per-repo Auto-fix toggle in the dashboard (off by default). When a run fails, codemagpie automatically kicks off a follow-up run that investigates the error and opens a fix PR.

Good to know

Loop-protected — an auto-fix run never triggers another auto-fix
Idempotent — each failed run is auto-fixed at most once, even across retries
Fires on failed runs only. A run that succeeds but whose tests fail gets a warning comment instead, not an auto-fix

Plans & rate limits

Limits are counted per user and reset on a rolling hourly and daily window (UTC). When you hit a limit, the run is marked rate_limited and codemagpie posts a heads-up comment on the issue or PR.

Feature	Free	Pro Coming soon
Runs per hour	5	Higher
Runs per day	50	Higher
Code generation & reviews	✓	✓
Auto-fix on failure	✓	✓

Free is the current tier and applies to everyone — the 5/hour and 50/day figures are the limits codemagpie enforces today. Pro pricing and limits are still being finalized.

Ready to try it?

Install codemagpie on your repo and open your first issue.

Install on GitHub