Multi-Agent · Multi-Project · Multi-OS · Multi-Machine
Aikito keeps coding-agent instructions, skills, MCP definitions, subagents, and durable memory in one Git-managed workspace, shared across agents and projects.
Aikito governs the workspace, agents maintain the memory, and you oversee it all.
AI agent resources fragment in three directions:
- Across tools: each agent requires a different configuration format
- Across projects: reusable knowledge, skills, and instructions are copied or maintained across multiple repositories
- Across time: valuable decisions and hard-won lessons disappear into old sessions
Aikito keeps the source files in one personal workspace and connects selected resources to each agent and project. No database, daemon, vector store, or hosted service is required.
The bundled durable-memory skill guides agents to retrieve useful notes, retain verified conclusions, and update stale knowledge. Notes are plain Markdown with Git history.
For example, a writing preference belongs in global memory, while an API retry decision belongs to its project. A project normally connects to global memory and its own notes; these scopes organize context, not filesystem access permissions.
New workspaces enable the workflow by default; synchronization connects it to agents. See memory usage and opt-out and why memory needs a maintainer.
Install and configure Aikito from https://github.com/lsaint/aikito. Read the README,
templates/skills/aikito/SKILL.md, and any linked documentation relevant to the setup, then follow their safety requirements to initialize the workspace, synchronize resources withaikito sync, and verify the result withaikito status. Before importing or changing any existing Agent configuration, show me the planned changes and conflicts and wait for my approval. When setup is complete, summarize what is ready and guide me through the next step, including whether to register my first code project. Do not register a project without my confirmation.
Install manually (macOS / Linux / Windows)
On macOS or Linux with Homebrew:
brew install lsaint/tap/aikito
aikito init workspace ~/aikito
aikito sync --dry-run
aikito sync
aikito statusReview the preview before applying synchronization. For existing configuration, see migration and safety.
On Windows, use the PowerShell installation guide.
Continue with the four-step tutorial to connect your first project and verify an instruction. For other tasks, use Agent Request Examples.
aikito status shows resource state across agents. Example output from a
configured workspace (agents and counts depend on your setup):
┌───────────────────────┬──────────────┬────────┬────────────┬───────────┐
│ Agent │ Instructions │ Skills │ MCP Config │ Subagents │
├───────────────────────┼──────────────┼────────┼────────────┼───────────┤
│ Codex │ ✓ │ 2 › │ 0 │ 0 │
│ Claude Code │ ✓ │ 2 » │ 0 │ 0 │
│ Antigravity CLI │ ✓ │ 2 » │ 0 │ 0 │
│ OpenCode │ ✓ │ 2 › │ 0 │ 0 │
│ GitHub Copilot CLI │ ✓ │ 2 › │ 0 │ 0 │
│ DeepSeek Harness │ ✓ │ 2 › │ 0 │ 0 │
│ Grok Build │ ✓ │ 2 › │ 0 │ 0 │
│ Pi │ ✓ │ 2 › │ – │ – │
└───────────────────────┴──────────────┴────────┴────────────┴───────────┘
✓ all synced · 8 agents · 2 skills · 0 notes across 1 scopes
aikito show memory lists retained knowledge by scope. This separate example
shows one global note and two notes for project example:
┌─────────┬───────────────────┬──────────────────────────────┬───────┬──────┐
│ Scope │ Note File │ Title │ Index │ Link │
├─────────┼───────────────────┼──────────────────────────────┼───────┼──────┤
│ Global │ writing-style │ Keep explanations concise │ ✓ │ – │
├─────────┼───────────────────┼──────────────────────────────┼───────┼──────┤
│ example │ api-retry-policy │ Retry external APIs safely │ ✓ │ ✓ │
│ example │ release-checklist │ Release verification steps │ ✓ │ ✓ │
└─────────┴───────────────────┴──────────────────────────────┴───────┴──────┘
Global notes hold cross-project knowledge; project notes hold local decisions. See memory operations for the full workflow.
Use synchronization troubleshooting to investigate
missing links, conflicts, or drift. Prefer a browser view? Run
aikito web for the local, read-only Console.
Aikito uses plain files and Git, with no background service required.
What Aikito does not do
- capture every agent action or conversation automatically
- run a vector store, embedding pipeline, or memory service
- inject context into every prompt through a background daemon
- orchestrate supervisor and worker agents
- replace your coding agent's native runtime
Already have agent configuration? Run aikito adopt for a read-only import
preview. Review the plan before applying it; see
adoption and backups.
Your workspace is a local Git repository. Review it for secrets and private data before publishing; removing a secret in a later commit does not erase it from history. Read the safety model and report vulnerabilities through the Security Policy.
- Getting started: installation through your first working instruction.
- Workspace and synchronization: source files, scopes, and resource ownership.
- Connect another machine: existing workspaces and custom paths.
- CLI reference: commands and shell completion.
- Comparison and FAQ: design choices and common questions.
Chat Distiller can turn browser AI conversations into Markdown notes in your Aikito Inbox. See the capture and review workflow.
Browse the full documentation site for more.
If you find Aikito useful, you can support its development.