In short:
ak-vibetakes a GitHub issue or a one-line request to a PR that is reviewed, fixed and labeled ready. It creates a worktree, then chainsak-plan,ak-cookorak-fix,ak-code-review,ak-shipandak-review-printo one pipeline. It skips none of the sub-skills' gates, and it does not merge unless you add--ship.
Disclosure: I maintain AgentKit and have an affiliate relationship with it: the AgentKit link in this post is an affiliate link; buying through it gets you 30% off.
Summary
Use it when you have an issue link or a one-line request and want one command to get you to a ready PR, or all the way to a merge and green CI with --ship. Tests, review, branch protection and security policy all stay in place.
flowchart LR
A["GitHub issue or request"] --> B["ak-vibe"]
B --> C["Reviewed PR, labeled ready"]
C --> D["Stops here without --ship"]
C --> E["Merge and green CI with --ship"]Every run turns on 4 points:
| Point | Question | Example |
|---|---|---|
| Input | Where does the run start? | A same-repo issue link is the source of truth; for a one-line request, a new issue is created only after validate and red-team |
| Route | Is this new work or a bug fix? | "Add CSV export" goes to ak-cook --tdd --auto; a 500 error goes to ak-debug, then ak-fix --auto |
| Ship mode | Which branch does the PR target? | Stable by default via ak-ship official; --beta uses ak-ship beta; --both runs beta, then stable |
| Stop point | When does the run end? | Without --ship: labeled PR; with --ship: green CI, an external blocker, or the same blocker after 3 fix attempts |
If a repo declares its own batch-merge mechanism (a merge train, a bot or a scheduled routine), vibe stops at the ready PR, even with --ship.
Sample prompt for an existing issue:
/ak-vibe <issue link>| Flag | What it is for | Since ak |
|---|---|---|
--ship | Merges the PR and follows CI until green | 1.0.0 |
--beta | Ships to the beta/dev branch instead of stable | 1.0.0 |
--both | Runs beta end to end, then stable | 2.4.0 |
--advice | Has the kongming advisor supervise the whole run | 2.5.0 |
--ultra | Plan and code-review pick the best of 5 | 2.15.0 |
Below is the detailed version: the run flow, 5 situations with prompts, each flag explained (when to use it, when you do not need it, what you get, which flags it combines with), the change history by ak release, and common pitfalls. The detailed version and the interactive page are for subscribers. Your agent can also search them through the portal's MCP.
Opens when your account has subscriber access
This guide is for subscribers
Once your account has access, the full piece, the interactive visual and the agent call all open.
- Sign in or create a modernEngineer accountReading access belongs to your account email.
- Choose a plan on the pricing page1, 3 or 12 months, paid by VietQR bank transfer. Access opens about a minute after the money arrives.
- Or redeem a Facebook subscriber codePeople supporting the page on Facebook get an activation code by message each month.
Already a subscriber? Sign in to read.
Use this piece in your agent
Get an API keyCopy the text below and paste it into Claude Code, Codex or whichever agent you use. The agent reads the piece and checks it against the repo you have open.
Read "ak-vibe: take an issue or request to a ready PR" on modernEngineer and apply it to this repo.
1. Call the content_get tool of the modernengineer MCP server with locale "en", slug "ak-vibe". If the modernengineer MCP server is not connected, stop and walk me through connecting it from https://modernengineer.dev/en/mcp.
2. Summarize the main steps of the piece and point out which apply to this repo.
3. Propose concrete changes and ask me before editing any file.Connect MCP in Claude Code (once)
claude mcp add --transport http modernengineer \
https://api.modernengineer.dev/mcp \
--header "Authorization: Bearer <API key>"Reading the full piece over MCP needs an API key from a subscriber account or one that bought this guide. Without access, the agent only gets the opening.
- Version
- v1.0.0
- Updated
- 22/10/2026
- Licence
- All rights reserved
- Slug
- ak-vibe
