Changelog
What changed in agent-kevin, release by release, in plain terms.
The highlights of each release, newest first. Every detail, including the upgrade steps a release carries, is in the plugin's CHANGELOG.md. After a plugin update, run upgrade to bring your home current (Updating).
0.9 · Oct 30, 2026
- An agent on its own Claude subscription now starts with
agent. Claude Code 2.1.312 stopped reading the subscription token from an agent'ssettings.local.json, so those agents were quietly billing your default login. The token now lives in the agent's secrets folder, and a smallagentcommand you add to your terminal once starts Claude Code with it.upgrademoves the token and offers to add the command. Billing per agent - The session banner warns when an agent with its own subscription was started with
claude, so a session never bills the wrong account without you noticing. - Claude Code 2.1.314 or newer is required. Setup and
upgradestop below it withclaude update.
0.8 · Oct 15 – 29, 2026
-
Four privacy opt-outs replace the traffic kill, and
/designcomes back. The home turns off telemetry, crash reports,/feedbackand the session survey with four settings in.claude/settings.json, instead ofCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, which also hid/design, artifacts and Remote Control.upgrademakes the swap. If your own~/.claude/settings.jsonsets the old variable, delete that line yourself, and turn off Help improve Claude in your Claude account. Privacy -
The status line counts down to each rate-limit reset on Pro and Max:
16% ↻ 2h · 56% ↻ 3d. Status line -
Explainers gain reveal cards, rails and accordions, for detail that stays one click away: a row of short phrases that each open a panel, a list beside one panel for long detail, and rows that open in place. Explainers
-
A Slack pack: read-only Slack through your own account.
slackgives a pulse across your channels, grouped by a channel map you own, and reads one channel, a thread or a search. Each workspace creates a Slack app once, andconfigure-skills→ Slack walks you through it. It never posts and never reads DMs. Slack -
The attention queue and sync show what Slack is waiting on: the mentions you owe a reply, threads where someone outside the workspace has waited an hour or more, and channels you joined that the channel map doesn't list yet, with an offer to sort them in. What's waiting
-
A GitHub sweep: everything on GitHub waiting on you, on one page.
engineer sweep(or "github sweep", "what do I owe on GitHub") finds the comments, reviews and conflicts waiting on you across your PRs, the reviews you owe and your issues, drafts a code-checked reply for each, and folds it all by issue with a Copy box and a Handled tick per item. Nothing is posted. GitHub sweep -
Sync counts what GitHub is waiting on: replies owed, re-reviews, pending reviews and your conflicting PRs, from numbers alone, and offers the sweep when any are owed. Sync
-
Sync saves the home before it starts, so the run's own changes land as a clean diff and the opening snapshot is the point to go back to if a run goes wrong. Saving a snapshot
-
Briefings close with ranked first moves: three to five actions across tasks due, sessions waiting on a decision, PRs and replies owed, and goals, instead of one first move. Sync now checkpoints your sessions before the briefing so the list sees them. How a briefing ends
-
"tldr" restarts step by step too, the same as "I didn't read that".
-
The focus skill is now
attention. Claude Code ships its own/focuscommand, so/agent-kevin:focusnever reached the skill. Run/agent-kevin:attention(or$attentionin Codex);where-am-iandtriageare nowattention checkpoint all, andupgrademoves your project pages and permission rules over. Attention -
A checkpoint is a checklist.
attention checkpointwrites the session you're in as done steps with their proof, what's in progress, the next step, decisions waiting on you with a recommended pick, and traps.attention checkpoint alldoes the same for every recent session, the waiting decisions first, then offers to jump to one. Checkpoints -
The Sessions page reads checkpoints, one line per step, and the Today feed shows each session's in-progress step. Sessions
-
The dashboard's Tasks tab "Needs attention" is now "Blocked · stale", so "attention" means one thing on the dashboard. Tasks and projects
-
"I didn't read that" restarts step by step. The agent answers in three lines, then walks through the rest one short step per reply.
-
Explainers gain step-through walkthroughs and clickable UI mocks. Explainers
-
A worktree on a base branch is never torn down, and a stalled Chromium launch retries instead of hanging a capture.
-
A routine can note and assign tickets without asking. When a queue profile's routine says its notes and assignments go ahead without asking, a sweep reads each new ticket, leaves a private note and hands it to a person, then lists everything it wrote. Cards, tasks and comments still wait for your yes. Helpdesk
-
The agent can assign a SupportCandy ticket to a teammate, and reads the ticket back to confirm the change took. Helpdesk pack
-
SupportCandy setup keeps the API out of the page cache. A caching plugin with REST caching on can serve the agent's reads to anyone, login or not; setup now turns that off. Helpdesk pack
-
Explainer and PR report diagrams take the page's colours, and code is highlighted, with added and removed diff lines marked. Explainers
-
Ticket, review and diff text can't break out of its untrusted wrapper, so a source can't speak outside it.
-
The agent can fix its own GitHub comment on an issue or a PR conversation, and never someone else's. Writes
-
Hand off a task to the team.
project handoff <id>opens a GitHub issue for a task's work on the project's repo, after checking for one already open and only once you approve the draft. The task keeps the issue's link, and sync offers to close the task when the issue closes. Tasks -
App Store bug reports become one card each.
helpdesk reviewsclusters recent reviews by what broke, at every star rating, and gathers each bug's cards, tickets and older reviews into one card or a comment on the open one. Sync counts the day's reviews and offers the pass when new ones arrive. App Store reviews -
An accepted issue is tracked through the fix. The engineer skill moves it to
in progresswhen work starts and, once the fix is proven, sets its milestone to the release it ships in and writesFixes #<n>, each on your yes. Engineer -
The agent can open a pull request from a pushed branch, and always asks first. Writes
-
A bare
engineer simplifyreviews this session's changes against the build, the full test suite and every caller, and fixes the clear findings before reporting. Simplify -
Tools that always ask stay that way. The server refuses
curl_run,seed_importandgithub_pr_createuntil their ask rule is in place, and Codex now asks before each of them too. MCP tools -
A classic token for an org that holds fine-grained ones for approval, and
github_pr_updatenow works on one. GitHub pack -
Raise a ticket as a bug, a feature or a task.
helpdesk raise 318proposes the kind with its reason, then files it wherever the queue profile's## Raisingsection sends that kind: a task or a GitHub card.helpdesk bug 318stays the shortcut for a bug. Helpdesk -
The pulse reaches older open tickets. A SupportCandy list filtered by status used to stop at the 1,000 most recently updated tickets, so older open ones never reached the pulse, routines or queue counts; it now reaches 10,000. Helpdesk
-
database_querychecks a secret column with aggregates only, never reading its values into the conversation. Database pack -
The
helpdeskskill works a support queue: a pulse that ranks what needs a person, a ticket's story, replies left as private notes for a person to send, and real bugs filed as a task or a GitHub card. When a card closes or development asks the user something, the pulse drafts the reply. Helpdesk -
A queue profile per project holds its own pulse, bug lifecycle, routines, tone and context, written by an interview:
helpdesk setup acme-shop, or just "set up helpdesk for acme-shop". Sync nudges each scheduled routine when it's due. Helpdesk -
Queue counts in sync and on demand. Every support queue's last 24 hours by status and tag, unassigned and newly opened, counted without reading a ticket: each project's queue and the no-project connection.
helpdesk statsasks for them any time. Helpdesk -
One helpdesk connection per project.
configure-skillsasks which project a SupportCandy site or Pylon workspace serves and names its keys after it; a named connection never borrows another's. Several sites or workspaces -
Tickets carry their people (the customer, the assignee, each message's author), and new reads list accounts, statuses, tags, teammates and macros. Helpdesk pack
-
An App Store pack reads any app's reviews from Apple's public feed, with no key, and a queue profile can add them to its pulse. Nothing replies to a review. App Store reviews
-
Review a stack of PRs from its edge in one report, each finding on its own layer, and preview every paste box as GitHub will render it. Pull requests
-
A GitHub token per owner. Each GitHub tool picks
GITHUB_TOKEN_<OWNER>for the repo it's called on, thenGITHUB_TOKEN, then yourghlogin, so repos under several orgs each get their own fine-grained token. Errors name the key and say whether the token was rejected, lacks a permission, or can't see the repo. GitHub pack -
GitHub writes, when your token allows them: open, edit, comment on and label issues with screenshots attached, and replace a PR's title or description. The token's permissions decide; nothing merges or closes. Writes
-
Your own PR's description, applied after you approve it. PR walkthroughs and replies offer to update it once you've seen the old and new text side by side; a teammate's PR is never edited. Pull requests
-
GitHub goes through the tools only: the GitHub pack denies
ghin the agent's own shell, Codex gets the same block as a forbidden rule, and a seed bundle carries it to the recipient. Codex -
A Helpdesk pack reads support tickets and leaves private draft notes in SupportCandy or Pylon; a person sends every reply. Helpdesk pack
-
The
guideskill writes a guide someone else can follow, as one polished page: a setup walkthrough, onboarding, or who does what in a shared workflow. Skills -
Task tools set a task's parent, checklist, dependencies and description, and say which fields they wrote. Tasks
-
Copy a diagram's Mermaid source from its expanded view, and jump back to the top of a long review or explainer. Engineer
-
Sync commits the
assets/andscripts/folders that 0.8.1 created, so the moved avatar lands in history. -
.claude/holds only what Claude Code reads. The avatar moves toassets/and your browser flows toscripts/browser/, in ascripts/folder for the scripts you keep for recurring tasks;upgrademoves them. Agent home -
Pin a report or doc to a project: it lives in the project's README and shows on its card, its focus page, and the Reports page. Dashboard
-
rename-agentshows a dry run first, keeps the home folder and dated records as they are, and records the old name underFormerlyso the agent knows it was once called that. Naming -
PR reviews check the description, read the whole conversation, and re-review only what changed, with an architecture section for large features and findings laid out as scenarios with proof. Pull requests
-
Expand and zoom any diagram on review and explainer pages. Engineer
-
The agent no longer calls itself a Claude Code plugin, so a Codex session isn't told it runs under Claude Code. Existing homes change the
Kindline inIDENTITY.mdby hand. Upgrades -
One
AGENT_*name per setting. AKEVIN_*variable no longer overrides its twin, and the firstupgraderenames what your home holds. Configuration -
Codex runs the MCP servers Claude Code runs, not just the plugin's own. Codex
-
Seed bundles carry browser flows and say who they're for, your own second agent or a teammate, never a
.env. Seed bundles -
The banner shows your agent's own name and emoji, and briefings add the Hijri date only when you keep that calendar.
-
Fixes for Claude Code 2.1.299 and 2.1.300: capture no longer saves logged API requests as turns, find-session no longer ranks every new session first, and a
/queuesent while a background agent runs goes out. -
A home still on
.kevin/upgrades through 0.7.3 first: this version no longer reads or moves that folder. Upgrades
0.7 · Oct 8 – 14, 2026
- See this conversation's reports with
/reportsand its session id with/session, each in a row above the prompt in Claude Code, and/todayshows its agenda there too. Mods - Queue a prompt until the current task ends with
/queuein Claude Code: each goes out as its own turn, in order, and a turn stopped with Esc or one that fails pauses the rest. Mods - PR reviews and replies end in one page with a Copy button on every comment, and reviews add two lanes (generated-code tells and performance), a reading guide, and the case against merging; a small, low-risk PR runs as three agents unless you pass
--full. Pull requests - Pin reports to the dashboard sidebar by listing them in
reports/pinned.md; every session's context names them, and the brain pass asks about a broken or stale one. Dashboard - Every generated page has an Auto / Light / Dark switch, Auto by default, from the dashboard to roadmaps and itineraries. Dashboard
- Explainers have a template: the
engineerskill writes the body, and a script checks it and wraps it in a page with a contents dropdown. Engineer - Pick a project's color with
hue:in its README, and see its roadmap and focus links on the card's first line. Tasks and projects /donesuggests the task to close in Claude Code, from the start of its id or a word of its title. Tasks- A new folder points at setup in Claude Code, with a Set up button above the prompt. Mods
- The shell guard holds the
cdand scratch-file rules, refusing acdthat would leave the home (in Claude Code) and a shared temp path found by pattern or picked by hand. Hooks - The Xcode pack stops asking before
RunCodeSnippetin Claude Code; the debugger stays gated. Coding rules - One command installs the plugin in Claude Code, adding the marketplace when it's missing. Install
- Notices: one place for upgrade and sync reminders, louder as they go unaddressed: sync by days since the last run, upgrade by releases behind. In the Claude Code terminal the top one sits above the prompt with a button that runs it and one that snoozes it until tomorrow; everywhere else it's in the session banner. Notices
- Sync offers a north-star roadmap at every run until the home has one, and the north star then heads your yearly goals. Daily rhythm
- The status line reads on a light terminal, following your Claude Code theme or the macOS appearance. Claude Code
- The dashboard lists the mods: a Mods tab on the Capabilities page, with the commands each adds and whether they've loaded on this machine. Capabilities
- One data folder name for every agent. The runtime folder moves from
.kevin/to.state/, and itsversion.jsonrecords which agent owns it. The firstupgrademoves it for you, with nothing to answer. How the move works - Secrets stay guarded in every home, including homes created when your global settings already carry their own deny list. Privacy
- A clear message when the move can't happen yet, such as a Windows file lock, with what to close before running
upgradeagain. - Instant commands in Claude Code:
/capture,/lesson,/doneand/todayrun without waiting on a reply. Mods - A repo's own instructions load the first time a session touches it, in Claude Code, so the agent follows that repo's conventions without being told to read them. Mods
- Sync shows its progress above the prompt, and its report quotes counted numbers. Sync
- Sync's closing question takes several picks, worked through in order or each queued as a task. Sync
- Claude Code 2.1.293 or newer is required. Setup and
upgradestop below it and say to runclaude update. Install
0.6 · Sep 29 – Oct 7, 2026
- Focus: your day in one place. Plan today, the week and the month, get a standup card, see where every session left off, and turn "I'm overwhelmed" into a sorted list. Attention
- Daily goals, set in the morning and scored at night. Daily rhythm
- A welcome after setup that suggests where to start. First session
- Audio and video. Transcribe voice memos and recordings on your Mac, grab screenshots at chosen moments, and turn a bug-report video into repro steps. Skills
- Drop folders, zips and PDFs into the inbox, and the next compile reads them. Capture
- A monthly brain pass. Self-review finds stale tasks, outdated memory and decisions worth keeping, and asks you about each. Self-evolution
- Sync reminds you after three days without one, and offers the brain pass when it's due. Sync
- Fewer, broader skills. Fifteen skills folded into five, each with playbooks for the different asks. Skills
- Setup asks about your world: what you're working on, what should land this year, and the company the agent works for, so the first sessions start with context. Onboarding
- Postman support for API request collections. API collections
- Python runs through uv, so scripts never install packages globally. Install
- Codex homes default to GPT-6.1 Sol. Codex
- Machine-specific settings live in
settings.local.json, so a home's shared settings travel cleanly. Configuration - Removed: renaming the runtime folder (
AGENT_RUNTIME_DIR). It was only partly supported and could leave secrets unguarded.
0.5 · Sep 23 – 29, 2026
- Tax and books. What you owe right now, deadlines as tasks, receipts and the monthly close. Tax and books
- Version history for the brain, kept on your machine, so any change to what the agent knows can be seen and undone. History
- Upgrades keep your edits. Template changes merge three ways against what you changed since the last upgrade. Upgrades
- Pull requests in the engineer skill: review a teammate's PR, answer the review on yours, or prepare yours for standup. Pull requests
- Safer worktree cleanup: a PR review removes the worktree it made once its report is saved, and the cleanup audit never offers a worktree a session is still working in. Worktrees
- Windows fixes: files with Windows line endings read correctly, and the one tool that needs a POSIX shell says so instead of failing halfway. Platforms
0.4 · Sep 6 – 23, 2026
- One manual for every host.
AGENTS.mdis the operating manual, and Claude Code reaches it through a short bridge. Hosts - Codex is a second host. Run the same home from Claude Code or Codex. Codex
- The engineer skill: a playbook for each kind of code task and the principles behind them. Engineer
- Second-model review. Have another model review your own branch, plan or document, then verify every finding against the work. Second-model review
- Xcode pack: build, test and run Apple apps from a session. Coding rules
- Self-review prunes first, and rules that prove useful in real homes move into the templates. Self-evolution
- A guard on shell commands that would write into the wrong folder after the session changed directory. Hooks
Earlier · Jun 20 – Sep 5, 2026
The foundations: the compiled brain and session capture, tasks and projects, briefings, the dashboard, skill packs for SEO, the browser, databases and GitHub, and seed bundles for handing an agent to a teammate. How it got here: What Kevin used to be.
Bring your Claude history
Move what the Claude app already knows about you into your agent, so it doesn't start from zero. Step by step, no coding needed.
Overview
Optional. Running agents well is less about the model and more about the terminal, the keybindings, the worktrees, and where the brain lives.