Personal Vertex AI. A phone-first agent engine that coordinates MMCP agents, model routing, tool permissions, GitHub ledgers, and RLM runs — built exclusively for one person, operated entirely from an iPhone.
This repo is the specification and roadmap for the Pocket Agent Engine (PAE) — a personal agentic stack that maps 1:1 with Google's enterprise agentic stack, but reduced to its essential form for a single user operating from a phone.
| Google Layer | PAE Equivalent |
|---|---|
| Agent Development Kit | Studio-OS-Chat + G-Force CLI + MMCP agent templates |
| Model Context Protocol | M-MCP (mobile-MCP layer) — m-mcp, m-mcp-messenger |
| Vertex AI Agent Engine | This repo — pocket-agent-engine |
| Agent2Agent (A2A) Protocol | m-mcp-messenger — signed envelope protocol over GitHub |
You are not competing with Google or Anthropic. You are building the personal reduction of the same architecture — a pocket command deck for one human, one iPhone, and a network of AI agents.
Do not make the phone the worker. Make the phone the agent command deck.
The iPhone is the signed command origin — it chooses agents, sends tasks, approves handoffs, and reviews results. GitHub is the durable cognitive ledger — it stores all state as versioned markdown. Local machines and cloud runners handle compute.
iPhone (Control Plane)
│
├── Send signed MMCP messages
├── Approve agent handoffs
├── Review results & issues
└── Trigger GitHub Actions / local runners
│
▼
GitHub (Cognitive Ledger)
│
├── spaces/*/inbox.md + outbox.md (agent mailboxes)
├── projects/*/status.md (live project boards)
├── threads/*.md (conversation history)
├── issues + PRs (task tracking)
└── .github/workflows/ (automation triggers)
│
▼
Runners (Compute Layer)
├── GitHub Actions (CI, issue creation, routing)
├── Local machine (RLM, code execution, tests)
└── API providers (Groq, OpenAI, Anthropic, Perplexity)
See docs/architecture.md for the full diagram and layer descriptions.
See docs/repo-map.md for how all 70+ existing repos plug into this engine.
See docs/build-order.md for the phased roadmap.
config/agents.json— Agent registryconfig/models.json— Model registry (provider routing)config/tools.json— Tool registryconfig/policies.json— Agent permission policies
The pae CLI is the primary interface for operating the engine from terminal or iOS Shortcuts.
See docs/cli.md for all commands.
MIT