Agentpack

Name: Agentpack
Author: ihorponom

by ihorponomversion 1.11.1i★ 18iRuns on your computer

Registry nameio.github.ihorponom/agentpack

Install

Overview

Description from the maker (original English)

Repo-native task continuity for AI coding agents: a reviewed task-state ledger served over MCP.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi2 of 2 passedChecked from public information; code not scanned yet
UsageiEarly↓ 226/wk · ★ 18

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Developer tools

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 2 of 2 passed
Runs on your computer with your user’s permissions (files, network, apps).
The registry lists no key to fill in.

You need

npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "agentpack": {
      "command": "npx",
      "args": [
        "-y",
        "agentpack-cli",
        "mcp"
      ]
    }
  }
}

Run this in your terminal

claude mcp add agentpack -- npx -y agentpack-cli mcp

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "agentpack": {
      "command": "npx",
      "args": [
        "-y",
        "agentpack-cli",
        "mcp"
      ]
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "agentpack": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "agentpack-cli",
        "mcp"
      ]
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

All apps, with pros and cons →

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 11, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account ihorponom, which owns the repo
✓ Pass
Still maintained
Code last changed 16 days ago
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Developer toolsi

More stars than 91% of the other 5739 servers in this category
Published to the registry more recently than 61% of the other 5739 servers in this category
Basic checks equal to or better than 100% of the other 5739 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Agentpack safe?

It passed 2 of 2 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 16 days ago, and the latest version (1.11.1) reached the registry 16 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: REA, Netdata, Front-End Checklist

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

REA

Reverse engineer anything from your terminal or agent with one CLI and MCP server.

by morlutoWidely used↓ 388.7K/wk★ 448.2KUpdated 16 days ago

Runs on your computer

Install

Netdata

Real-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.

by netdataWidely used★ 81.3KUpdated 6 days ago

Runs in the cloud

Install

Front-End Checklist

Review frontend code and live pages against 386 quality-gated web development rules.

by thedaviddiasWidely used★ 74.7KUpdated 37 days ago

Runs in the cloud

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Agentpack

Repo-native task continuity for AI coding agents.

Agent memory remembers how you work. Agentpack remembers where the task stands.

Your agent spent an hour on a task. It found the cause, rejected two approaches, and wrote down the next step. Then the context was compacted, or the chat closed. The next session starts from zero and does the same investigation again.

Agentpack keeps the task state in your repo. Connected agents record the goal, decisions, dead ends, verification evidence, and checkpoints in .agentpack/ while they work. Then the next session loads that state and continues: the same agent after compaction, a different client, or you next week.

Here it is in action. In session 1, an agent works on a flaky test and records a decision, a dead end, and a checkpoint through the Agentpack MCP tools. In session 2, the next day with an empty context, one load_context call brings the task back:

▶ Watch the 80-second explainer, with sound

To try the same flow by hand from the CLI, see docs/DEMOS.md.

Local-first. Plain files in your repo. No cloud, no telemetry, no network calls.
Made for agents. A local MCP server and generated project instructions (AGENTS.md, CLAUDE.md, Cursor rules) tell agents when to load and record state.
Open to people. The CLI shows the same state, so you can inspect it, fix it, or hand it off yourself.

How is this different from agent memory?

Claude Code memory, Codex memories, and CLAUDE.md or AGENTS.md keep how to work: your preferences, project conventions, and facts that stay true. Agentpack keeps where the work is: the goal of the current task, its constraints, decisions, dead ends, next actions, and verification result.

	Agent memory	Agentpack
Holds	Preferences, conventions, long-lived facts	The state of one task
Lives in	The profile or account of one client	`.agentpack/` in the repo, local by default, portable with task bundles
Read by	That client only	Any MCP client: Claude Code, Codex, Cursor, Claude Desktop
Shape	Free-form notes, recalled by relevance	A Task Passport per task: goal, lifecycle, the paths it may change, and verification bound to a commit
Staleness	Not tied to file changes	Notes about files store the file hash, so Agentpack flags a note when its file changes

Use both. Memory keeps how you like to work. Agentpack keeps what the task needs next.

Quick start

Agentpack needs Node.js 20 or later.

npm install -g agentpack-cli

cd path/to/your/repo agentpack init # once per repo agentpack install claude --write # per client: codex | claude | cursor | claude-desktop agentpack install git-hooks --write # optional: task gate check before each commit

Restart or reconnect your coding agent, and approve the Agentpack server or hooks when the client asks. From then on, the agent loads the task state when a session starts, records decisions and evidence while it works, and creates checkpoints at meaningful points.

To check the setup, run agentpack doctor. To see the task state yourself, run agentpack resume --preset agent --query " ".

In a Git repository, init adds the local Agentpack files to .git/info/exclude. The list includes .agentpack/, .mcp.json, .claude, .codex, .cursor, AGENTS.md, and CLAUDE.md. Agentpack does not change your .gitignore. Files that Git already tracks stay tracked.

For each client, docs/INTEGRATIONS.md shows what the installer writes and why.

How it works

When a session starts, the agent loads a compact summary: the current Task Passport, recent checkpoints, decisions, and source conclusions.
While it works, the agent records what is worth keeping: decisions, failed approaches, and verification evidence. It can also record a source conclusion: a short note about what a file does, stored with the file hash. If the file changes later, Agentpack flags the conclusion. A matching hash shows that the file is unchanged, not that the conclusion is correct.
At a natural stop, the agent creates a checkpoint with the status, the next actions, and the Git state.
The next session, in any MCP client, continues from that state. It does not rebuild the task from chat history.

Each task has a Task Passport: the goal, status, constraints, write scope (the paths the task may change), next actions, and verification. You can start, park, switch, and finalize tasks, so each handoff is explicit.

The task gate checks edits against the current Passport. The client installers add native hooks for Claude Code, Codex, and Cursor. install git-hooks adds a pre-commit check. By default, the gate only warns. Set "gateMode" in .agentpack/config.json to "block" to stop edits outside the write scope or outside an active task, or to "off" to turn the gate off. Hooks are a guardrail, not a sandbox. See docs/CLI.md.

The summary stays inside a token budget. The agent gets the useful state back, not the full history.

More features

Task bundles. Export a task to one JSON file, and import it in a fresh clone or on another machine. See docs/TASK-PASSPORT.md.
Tasks across repositories. One Passport can cover changes in several repositories, each with its own write scope.
Monorepo focus. Give each part of a monorepo (api/, frontend/, cron/) short tasks with their own write scope. The task gate warns when the agent leaves that part.
Usage reports. agentpack usage report reads local Claude Code and Codex transcripts and shows the token use of a task, including the Agentpack share. Nothing leaves your machine.
Read-only inspector. agentpack tui shows tasks, evidence, and checkpoints in the terminal. See docs/TUI.md.
Builder subagent. Codex, Claude Code, and Cursor installs include an optional builder for larger implementation work. The main agent says what it will hand off before it uses the builder. Small tasks stay with the main agent.

When it helps

The context is compacted in the middle of a task, and the next turn needs the state back.
You start a new chat on a task that is still open.
You change between Claude Code, Cursor, Codex, or another MCP client.
You come back to a refactor or a bug fix days later.
Another agent continues from your checkpoint.

Agentpack context also uses tokens. The compact output keeps the task state available without the full ledger history.

Security posture

Zero runtime dependencies, exact dev dependencies, a committed lockfile, and ignore-scripts=true.
No telemetry and no network calls in normal CLI or MCP operation.
Best-effort redaction of values that look like secrets in stored context and handoff output.
GitHub Actions publishes each release with npm provenance (Trusted Publisher, no long-lived tokens). To verify, run npm audit signatures.

See SECURITY.md for the full policy, including what Agentpack reads outside the repo.

Documentation

docs/INTEGRATIONS.md: setup for Codex, Claude Code, Cursor, Claude Desktop, and Git hooks
docs/TASK-PASSPORT.md: task lifecycle, handoffs, additional repositories, and task bundles
docs/CLI.md: full CLI reference, budgets, and manual workflows
docs/MCP.md: MCP server contract and tools
docs/DEMOS.md: short continuity demos to run yourself
docs/TUI.md: the read-only terminal inspector
docs/LEDGER-HYGIENE.md: keep the ledger small and useful

Contributing

Clone the repo and use Node.js 20 or later:

npm ci --ignore-scripts

npm test npm run mcp:smoke node dist/src/agentpack.js --help

See docs/SETUP.md for the development setup and docs/RELEASING.md for the release steps.

Mirror: Codeberg. Issues, releases, and npm provenance stay on GitHub.

Agentpack

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Which apps can use it

Related guides

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Developer toolsi

Common questions

Alternatives

REA

Netdata

Front-End Checklist

README from the maker

Agentpack

How is this different from agent memory?

Quick start

How it works

More features

When it helps

Security posture

Documentation

Contributing