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.

$ git clone https://github.com/AIOSAI/AIPass.git
$ cd AIPass && ./aipass install

Get Started

View on GitHub

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 subscription — Pro or Max. No API keys for core features. No extra costs. AIPass orchestrates, Claude Code 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. Clone and install

git clone then ./aipass install. One command creates the venv, puts aipass and drone on your PATH, and chains into a guided setup that ends in a live conversation with your first agent.

2. Say hi

Setup drops you straight into the conversation. Kill the terminal, come back tomorrow, say hi — your agent reads its memory, knows its role, and picks up exactly where you left off.

3. Scale up

Add more agents when your project needs them, or spin up a whole new project around a resident manager with aipass new. Agents 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 17 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
      .aipass/          # Agent instructions
      .ai_mail.local/   # Mailbox
      apps/             # Your agent's code
      logs/             # Structured logs
      README.md         # Agent readme

FAQ

What CLI providers does AIPass support?

Claude Code. AIPass runs it as an official subprocess using your existing Pro or Max subscription. No API keys needed for core functionality.

What platforms does it run on?

Linux and WSL. AIPass is a Python package that runs in your terminal alongside your existing development tools.

Do I need all 17 agents?

No. Start with 1. The 17 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 Claude subscription (Pro or Max) to run your agents.

Start building with agents that remember.

$ git clone https://github.com/AIOSAI/AIPass.git
$ cd AIPass && ./aipass install

View on GitHub

Join r/AIPass