AgentLayer▸docs
Reference

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's settings.local.json, so those agents were quietly billing your default login. The token now lives in the agent's secrets folder, and a small agent command you add to your terminal once starts Claude Code with it. upgrade moves 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 upgrade stop below it with claude update.

0.8 · Oct 15 – 29, 2026

  • Four privacy opt-outs replace the traffic kill, and /design comes back. The home turns off telemetry, crash reports, /feedback and the session survey with four settings in .claude/settings.json, instead of CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, which also hid /design, artifacts and Remote Control. upgrade makes the swap. If your own ~/.claude/settings.json sets 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. slack gives 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, and configure-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 /focus command, so /agent-kevin:focus never reached the skill. Run /agent-kevin:attention (or $attention in Codex); where-am-i and triage are now attention checkpoint all, and upgrade moves your project pages and permission rules over. Attention

  • A checkpoint is a checklist. attention checkpoint writes 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 all does 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 reviews clusters 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 progress when work starts and, once the fix is proven, sets its milestone to the release it ships in and writes Fixes #<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 simplify reviews 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_import and github_pr_create until 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_update now works on one. GitHub pack

  • Raise a ticket as a bug, a feature or a task. helpdesk raise 318 proposes the kind with its reason, then files it wherever the queue profile's ## Raising section sends that kind: a task or a GitHub card. helpdesk bug 318 stays 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_query checks a secret column with aggregates only, never reading its values into the conversation. Database pack

  • The helpdesk skill 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 stats asks for them any time. Helpdesk

  • One helpdesk connection per project. configure-skills asks 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, then GITHUB_TOKEN, then your gh login, 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 gh in 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 guide skill 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/ and scripts/ folders that 0.8.1 created, so the moved avatar lands in history.

  • .claude/ holds only what Claude Code reads. The avatar moves to assets/ and your browser flows to scripts/browser/, in a scripts/ folder for the scripts you keep for recurring tasks; upgrade moves 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-agent shows a dry run first, keeps the home folder and dated records as they are, and records the old name under Formerly so 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 Kind line in IDENTITY.md by hand. Upgrades

  • One AGENT_* name per setting. A KEVIN_* variable no longer overrides its twin, and the first upgrade renames 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 /queue sent 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 /reports and its session id with /session, each in a row above the prompt in Claude Code, and /today shows its agenda there too. Mods
  • Queue a prompt until the current task ends with /queue in 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 engineer skill 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
  • /done suggests 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 cd and scratch-file rules, refusing a cd that 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 RunCodeSnippet in 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 its version.json records which agent owns it. The first upgrade moves 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 upgrade again.
  • Instant commands in Claude Code: /capture, /lesson, /done and /today run 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 upgrade stop below it and say to run claude 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.md is 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.

On this page