AIPass – AI agents whose memory is small JSON files they own

Persistent Agent Workspace

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

What you get #

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

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.

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