AIPass – AI agents with persistent identity, memory, and email

AIPass, a CLI-native scaffold from AIOSAI, adds persistent memory, identity, and coordination to AI agents, running locally on plain files with no cloud or external APIs, and drives the existing Claude Code binary from Anthropic, requiring no extra API keys for core functionality. The tool, available via GitHub, PyPI, and aipass.ai, installs with one command, bootstraps a 17-agent reference fleet, and ends in a terminal conversation with a concierge that greets users by name and reports health checks. It supports a shared workspace where all agents work on the same filesystem, and offers a 'drone' command to reach any agent, with options for non-interactive shells and automatic hook merging.

Persistent Agent Workspace AI agents that remember, collaborate, and never start from zero. aipass.ai https://aipass.ai · PyPI https://pypi.org/project/aipass/ · r/AIPass https://reddit.com/r/AIPass · Discussions https://github.com/AIOSAI/AIPass/discussions When the task gets complex, you become the coordinator — copying context between tools, dispatching work manually, keeping track of who's doing what. You are the glue holding your AI workflow together. Multi-agent frameworks tried to fix this. But they isolate every agent in its own sandbox. Separate filesystems. Separate context. One agent can't see what another just built. Nobody picks up where a teammate left off. That's not a team. That's a room full of people wearing headphones. AIPass is a CLI-native scaffold that adds persistent memory, identity, and coordination to your AI agents. You bring your project — AIPass adds the agent layer on top. No UI, no dashboard, no cloud. Everything is plain files on your machine; delete the directory and it's gone. Agents are persistent. They remember across sessions. Expertise develops over time. Nobody starts from zero. Bring your own project. AIPass adds agent infrastructure to whatever you're building. It's a scaffold, not a product — you shape it. Everything is local. Memory is JSON files. Communication is local mailbox files. No cloud, no external APIs. Shared workspace. All agents work on the same filesystem, same project, same time. No sandboxes. One command for everything. drone @agent command reaches any agent. Learn it once, use it everywhere. Runs on your existing Claude subscription. AIPass drives the same Claude Code https://code.claude.com/docs binary you already run — Pro or Max. No extra API keys, no extra costs for core functionality. git clone https://github.com/AIOSAI/AIPass.git cd AIPass ./aipass install One command does it all: builds the environment, puts aipass + drone on your PATH, bootstraps the 17-agent reference fleet, runs a health check aipass doctor --fix — heals what it can, automatically — and ends in a conversation . The AIPass concierge opens right in your terminal with your install report and health verdict in hand: it greets you by name, shows you around, and walks you through what your machine still needs — every machine is different. Along the way, in an interactive shell, expect three quick prompts: your git identity name + email, if not already configured globally — this is yours, not ours, so skip is always an option, and a bad address is never silently stored , your name , so the concierge knows what to call you, and how the session should run asks before system-changing commands by default, or full autonomy . Anything skipped or still missing gets collected into one "action needed" summary at the end, right before the welcome conversation opens — no project prompt, nothing else to answer. Project creation comes later, when you're ready see below . Come back tomorrow, say "hi", and it picks up exactly where you left off. That's the whole interface. Options: --no-chat skips the welcome chat. Non-interactive shells CI, pipes complete with defaults and exit 0 — no prompts, no spawned sessions; the handoff prints as a next-step command instead. The installer wires Claude Code hooks automatically — merging with any hooks you've already configured, never overwriting them. ./aipass is a thin repo-root launcher over setup.sh ; after setup it forwards to the installed aipass binary. Two ways in. From anywhere inside your AIPass environment, aipass new builds a complete project around a resident manager agent: aipass new my-project --template python Project + resident manager agent + git birth commit It mints the project registry, spawns a full citizen identity, memory, mailbox, birth certificate at src/my project/my project , makes the first commit — and drops you straight into a conversation with your new manager. Or bring your own directory, anywhere on disk: cd ~ && mkdir my-project && cd my-project aipass init run Guided setup — project, first agent, ends in the conversation Either way your agent has identity, memory, a mailbox, and access to every AIPass service — planning, quality audits, dispatch, real-time monitoring. aipass init Just the scaffold no guided setup aipass init agent my agent Add another agent aipass doctor Check system health aipass feedback off Silence the occasional how-are-we-doing ask The clone already includes all 17 agents working together — the reference implementation that maintains AIPass itself: cd src/aipass/devpulse claude Talk to the orchestrator drone @seedgo audit aipass Quality checks across all agents drone @flow create . "Add user auth" Create a work plan drone @ai mail dispatch @agent "Subject" "Body" Send a task + wake an agent Need help? Ask in Discussions or file feedback — both take 30 seconds. Memory. Every agent owns a .trinity/ directory — identity, session history, learnings — read on startup, updated as it works. Memory starts as plain JSON, no setup required. When files fill up, older entries automatically archive into ChromaDB for long-term semantic search. Nothing is lost. One structure. Every agent — yours and the reference fleet — shares the same layout. If you know one agent, you know all of them: src/my project/<agent / ├── .trinity/ Identity + memory persists across sessions ├── .ai mail.local/ Mailbox receives tasks, sends results ├── apps/ Entry point → modules → handlers └── README.md Domain knowledge read on startup One router. drone @branch command args reaches any agent — routing, access tiers, and @agent resolution handled for you. Agents use the same commands to reach each other: they dispatch work, share findings, and wake whoever they're waiting on. AIPass ships with 17 core agents that maintain and develop the framework itself — proving the architecture works at scale. You don't need any of these to use AIPass in your own project. They're here as examples and as services your project can call. devpulse orchestrator ├── aipass — concierge + onboarding aipass init, doctor, profile ├── drone — command routing + @agent resolution ├── seedgo — automated quality standards ├── prax — real-time monitoring + runaway-log detection across all agents ├── ai mail — agent-to-agent communication + task dispatch ├── flow — plan lifecycle, templates, auto-archival ├── spawn — creates new agents anywhere on your filesystem ├── hooks — hook engine, sound control, per-project config ├── memory — automatic archival, ChromaDB, semantic search ├── api — LLM access layer OpenRouter, multi-provider ├── trigger — event-driven automation + self-healing ├── cli — terminal formatting and rich output ├── backup — local-first snapshots + restore optional Drive sync ├── daemon — cron-style task scheduler each branch owns its schedule ├── skills — discoverable capability units any agent can run └── commons — the social space — post, comment, vote, gather Agent details You interact with one: devpulse /AIOSAI/AIPass/blob/main/src/aipass/devpulse/README.md — the orchestrator. You talk to it, it coordinates everyone else. Core infrastructure — how agents connect: | Agent | Role | |---|---| aipass | aipass init , doctor, profile, onboarding drone drone @branch command to the right agent ai mail memory api spawn Quality and operations — how the system stays healthy: | Agent | Role | |---|---| seedgo | prax flow hooks trigger cli backup daemon Capabilities and community — what agents can do and where they gather: | Agent | Role | |---|---| skills | commons Beta. Actively developed by a solo developer working with the AI agents themselves — every PR, every test, every fix is human-AI collaboration. | Metric | Value | |---|---| | Version | See | Each agent documents its own operational status in its branch README — what works, what doesn't, and why. - Python 3.10+ Claude Code https://code.claude.com/docs - Linux or WSL sudo access optional for /usr/local/bin symlinks — falls back to ~/.local/bin without sudo - API keys optional OpenRouter/OpenAI — for optional add-on agents Uninstall AIPass stores everything locally in your project directory. To remove it: Remove AIPass files from your project rm -rf .aipass/ .claude/ .ai mail.local/ hooks/ src/ rm -f CLAUDE.md AGENTS.md REGISTRY.json .gitignore If you ran the backup system, also remove its local state + shipped config rm -rf .backup/ && rm -f .backupignore No cloud accounts, no external services, no cleanup beyond your local filesystem. Use spawn's delete command to cleanly archive and deregister: drone @spawn delete @agent name This archives the agent's directory and removes it from the registry. Subscriptions & Compliance AIPass runs on your existing Claude subscription — Pro or Max. No API keys required for core functionality. No extra costs beyond your existing subscription. This works because AIPass runs Claude Code as an official subprocess — the same binary you'd run yourself in a terminal. It doesn't extract credentials, proxy API calls, or intercept tokens. Your subscription stays within the provider's infrastructure at all times. - Extract or redirect subscription OAuth tokens - Intercept CLI-to-provider communication - Bypass rate limits or prompt caching - Impersonate official CLI clients Claude Code is proprietary but officially supports hooks and subprocess usage. API keys are only needed for optional add-on agents OpenRouter/OpenAI . For server/automated deployments, API key authentication is recommended per Anthropic's guidance .