Install

Portable Agent Layer

Your AI forgets you.
PAL doesn't.

Open-source memory and skills, shared by Claude Code, Cursor, Codex and every agent you use.

$bun add -g portable-agent-layer && pal cli init
Star on GitHub
Works with
  • Claude Code
  • opencode
  • Cursor
  • Copilot
  • Codex
  • Antigravity
  • macOS
  • Linux
  • Windows

01same prompt, two sessions

The first prompt of a session shouldn't be a recap.

Same agent, same question. The only difference is what it knew before you typed.

without PAL
  1. youPick up where we left off.
  2. agentI don't have context from earlier sessions. What's the project, the stack, and what were you working on?
  3. # ten minutes of recap before any work
with PAL
  1. palsession startidentity · 3 projects · handoff loaded
  2. youPick up where we left off.
  3. agentFooter next. You review one verified step at a time, so I'll stop once it renders.
  4. # straight to work

02what every agent gets

Install once. Every agent gets all of it.

It learns from your corrections.

Tell an agent it got something wrong and PAL labels the mistake, drafts a rule, and asks you once. Approve it and every agent follows it from the next session.

  1. you“Don't batch the commits. One at a time.”
  2. →correction labelled
  3. →rule drafted, steers nothing yet
  4. $pal cli rule approve
  5. ✓every agent follows it, next session

Remembers who you are.

Goals, preferences, active projects and the handoff from your last session load before your first prompt.

Done means checked.

Real work runs through five phases. Nothing is done until each criterion has evidence.

  1. observe
  2. plan
  3. execute
  4. verify
  5. learn

27 skills in the box.

Research, PDFs, decks, first-principles thinking. Need another? Describe it, and create-skill writes it and links it into every agent.

No API key needed.

PAL's background work runs through the agent subscription you already pay for.

Guardrails on.

A hook checks every command before it runs and blocks the destructive ones.

03how it works

Three steps. Then you forget it's there.

Set it up once per machine. After that, PAL works inside the agents you already use.

  1. 01

    Install

    One global package. PAL runs on Bun 1.4 or newer.

    $bun add -g portable-agent-layer
  2. 02

    Connect

    Finds the agents you have installed and wires in its hooks, skills and instructions.

    $pal cli init
    • Claude Code
    • opencode
    • Cursor
    • Copilot
    • Codex
    • Antigravity
  3. 03

    Work

    Use any agent as usual. There's nothing new to run.

    session start
    identity, preferences, projects and your last handoff load
    session end
    a summary and any corrections are saved for next time

04yours

Your context belongs to you. Not to a vendor.

Plain files in ~/.pal. MIT licensed. One zip to move it.

Plain files
Everything lives in ~/.pal as files you can open and read.
pal cli export / import
One zip moves it to a new machine. Your API keys stay behind.
Open source, MIT
Read every line, fork it, keep it.

05questions

Before you install.

What is PAL?

PAL (Portable Agent Layer) is open-source memory, skills and rules shared by Claude Code, opencode, Cursor, Copilot, Codex and Antigravity. When a session starts, PAL loads who you are, your projects and where you left off. When the session ends, it saves a summary and any corrections as plain files in ~/.pal.

How is this different from a CLAUDE.md or rules file?

A CLAUDE.md or rules file is text you write and keep current by hand. PAL keeps one memory for every agent and writes to it on its own: a summary of each session, a handoff for the next one, and the rules you approved from your corrections. Your project's CLAUDE.md keeps working alongside it.

Do I need Bun?

Yes. PAL runs on Bun 1.4 or newer and won't run on Node.js, so install Bun from bun.sh first.

Does it cost anything or need an API key?

No. PAL is free and MIT licensed. Its background work, like session summaries and capturing corrections, runs through the CLI of the agent you're using, on the subscription you already pay for. API keys are only optional fallbacks.

Where does my data live?

In ~/.pal, as plain files on your machine. Background calls go through your agent's own CLI, so they reach the same provider your sessions already do. pal cli export packs it into one zip, and the API keys in ~/.pal/.env stay behind.

Can I use it with only one agent?

Yes. pal cli install --claude (or --opencode, --cursor, --antigravity) installs PAL for that agent only. Without a flag it connects every agent it finds: Claude Code, opencode, Cursor, Copilot, Codex and Antigravity.

How do I remove it?

pal cli uninstall removes PAL's hooks and skills from your agents. It takes the same agent flags as install.

How does it stay up to date?

pal cli update updates PAL and reinstalls its hooks. Setup also asks once whether to do this on its own: when a session closes, PAL checks for a release at most once an hour and installs it.

Stop re-explaining.
Start compounding.

One install. Every agent you use picks up the same memory, method and rules from the next session on.

$bun add -g portable-agent-layer && pal cli init
Star on GitHub