Persistent Agent Workspace

AI agents that remember, collaborate, and never start from zero.

Drop AIPass into any project folder. Your agents persist between sessions, share context, coordinate through mail, and pick up exactly where they left off.

$ pip install aipass
$ aipass init run

Get Started

View on GitHub

Terminal demo showing aipass init, first agent conversation, and memory persistence across sessions

What you get

Two commands. One project folder. Agents that actually stick around.

Persistent Memory

Agents remember previous sessions, key learnings, and collaboration patterns. Kill the terminal, come back tomorrow, pick up where you left off. No re-explaining.

Agent Coordination

Agents communicate through a built-in mail system. They dispatch tasks to each other, share findings, and work together across your codebase without you playing messenger.

Your CLI, Your Subscription

Runs on your existing Claude Code, Codex, or Gemini subscription. No API keys for core features. No extra costs. AIPass orchestrates, your CLI does the work.

How it works

AIPass gives your project a scaffold: agent directories, memory files, a routing layer, and a planning system. You bring the project, AIPass brings the infrastructure.

1. Install and init

pip install aipass then aipass init run. A 12-step guided setup creates your first agent with identity, memory, and tools. Under 2 minutes.

2. Say hi

Open your agent's directory and start a conversation. It reads its memory files, knows its role, and picks up context from previous sessions automatically.

3. Scale up

Add more agents when your project needs them. One agent for backend, one for frontend, one for docs. They coordinate through drone commands and mail.

Bring your own project

AIPass works with any codebase. Python, JavaScript, Rust, Go, whatever you're building. It adds a scaffold alongside your existing code and stays out of the way.

Start with 1 agent for a side project. Scale to 3 for a web app (backend, frontend, design). The reference implementation runs 13 agents that maintain AIPass itself.

# What aipass init creates
your-project/
  src/your_project/
    your-agent/
      .trinity/          # Memory files
        passport.json   # Identity
        local.json      # Session history
        observations.json# Learnings
      apps/             # Your agent's code
      tests/            # Agent tests
      tools/            # Agent tools
      CLAUDE.md         # Agent instructions

FAQ

What CLI providers does AIPass support?

Claude Code and Codex are fully supported. AIPass runs each CLI as an official subprocess using your existing subscription. No API keys needed for core functionality.

What platforms does it run on?

Linux and WSL are the primary targets. macOS has partial support. AIPass is a Python package that runs in your terminal alongside your existing development tools.

Do I need all 13 agents?

No. Start with 1. The 13 agents in the repo are the reference implementation that maintains AIPass itself. Your project might need 1 agent for a side project, or 3 for a web app. Scale as needed.

How is this different from CrewAI, LangChain, etc.?

Most agent frameworks focus on task orchestration: define a workflow, run it, get output. AIPass focuses on persistence: agents that live in your project, remember across sessions, and develop expertise over time. It's a workspace, not a pipeline.

Is it free?

Yes. AIPass core is free and open source (MIT). You just need an existing CLI subscription (Claude Pro/Max, Codex, etc.) to run your agents.

Start building with agents that remember.

$ pip install aipass && aipass init run

View on GitHub

Join r/AIPass