portable-agent-layer weekly downloads statistics

Portable Agent Layer (PAL)

Your AI forgets you. PAL doesn't. Free, open-source memory, skills and rules shared by Claude Code, opencode, Cursor, GitHub Copilot, Codex and Antigravity CLI. Install it once, and every agent starts the next session knowing who you are, what you're working on and where you left off.

Website: pal.konvert7.com

PAL lets you carry your agent context across Windows, macOS, and Linux, and work across different agent runtimes and interfaces such as Claude Code, opencode, Cursor, GitHub Copilot, Codex, and Antigravity CLI. Its core idea is simple: your knowledge and workflows should belong to you, not to a single machine, tool, or vendor.

Inspired in part by Daniel Miessler's work on LifeOS. PAL is an independent open-source implementation focused on portability across platforms and agents. It is not affiliated with or endorsed by Daniel Miessler.

---

Why PAL?

Most AI setups are fragmented.

Your prompts live in one place, your context in another, your notes somewhere else, and your workflows are often tied to a specific operating system or a specific agent tool.

PAL is designed to fix that.

With PAL, you can:

• keep your AI workflow portable
• move accumulated knowledge between machines
• work across multiple agent environments
• avoid lock-in to a single platform or interface
• build a durable personal layer that outlives any one tool

---

Install

Prerequisites

Bun is required. PAL is built on Bun and will not work with Node.js or other runtimes. Install it with curl -fsSL https://bun.sh/install | bash.

• Bun >= 1.4.0
• At least one of: Claude Code, opencode, Cursor, GitHub Copilot CLI, Codex, or Antigravity CLI

Package mode (recommended)

bun add -g portable-agent-layer
pal cli init

Repo mode (for development / contributors)

git clone https://github.com/kovrichard/portable-agent-layer.git
cd portable-agent-layer
bun install
bun run install:all

Then put pal on your PATH from the checkout. An alias is not enough: agents run skills in non-interactive shells, which never load it.

bun link

---

Quick start

pal cli init          # scaffold home, install hooks for all targets
pal                   # start the first installed agent in the terminal
pal cli status        # check your setup

---

Commands

Command	Description
pal	Start the first installed agent, in order: Claude Code, Codex, Cursor CLI, Copilot CLI, opencode, Antigravity CLI. Claude sessions print a summary on exit
pal cli init	Scaffold PAL home directory and install hooks
pal cli install	Register hooks/skills for targets
pal cli uninstall	Remove hooks/skills for targets
pal cli update	Update PAL (git pull or npm update) and reinstall hooks. Install asks once whether to do this on its own: when a session closes PAL checks for a release (at most hourly) and installs it, so opening PAL is never slowed. A failed update waits a day before retrying. The switch lives in the control room under Settings → Updates. On a repo install an update waits while the clone has uncommitted changes. --canary switches a package install to the canary prerelease channel; from then on plain pal cli update, auto-update and the update notice follow canary until --stable switches back. Neither ever installs an older version than the one you have
pal cli export	Export user state (telos, memory) to a zip
pal cli import	Import user state from a zip
pal cli status	Show current PAL configuration
pal cli doctor	Find what is wrong and the command that fixes each problem (--verbose lists every check, --json for agents); exits 1 on any failure
pal cli migrate	Run pending data migrations (non-destructive)
pal cli analyze [--actionable]	Learning analysis: rating trends, failure patterns, graduation candidates
pal cli usage	Summarize token usage and estimated cost
pal cli cost	What each month was paid against its API-equivalent cost, per agent
pal cli wrapped [--year <yyyy>]	A year of your work in numbers, read from the event log
pal cli patterns	How you work across projects, read from the event log
pal cli progress [show|list|open|enter|park|wait|done|stopped|decide|attach|follow-up]	The progress tree: what you are on in this project, where it stopped, what is parked or waiting, and the decisions and artifacts on each node. Detours are child nodes and done returns to the parent. The active node rides along in every session and prompt, and your own commits attach to it at turn end
pal cli content preserve	Copy every Claude Code transcript, gzipped, into memory/content/ before Claude Code deletes it (30 days by default). Runs on its own whenever a session closes; the content store never leaves the machine, so export skips it
pal cli events discord-nag <sent|answered>	For a bot outside PAL: record a nag it sent (--kind <kind>), or the…