aikito

Aikito

Multi-Agent · Multi-Project · Multi-OS · Multi-Machine

简体中文 · Homepage · Documentation

Aikito gives you one place to govern the context your coding agents share.

Manage instructions, skills, MCPs, subagents, and durable memory across agents, projects, and machines.

Quick Start

1. Install

With uv (recommended cross-platform) or Homebrew (macOS / Linux):

uv tool install aikito
# or: brew install lsaint/tap/aikito

2. Set Up Your Workspace

Bring your existing Agent setup under Aikito in 30 seconds:

aikito init workspace ~/aikito
aikito adopt  # use --dry-run to preview, --verbose for full paths
aikito sync
aikito status

adopt and sync preflight their complete plans before writing. Starting from scratch? Simply skip aikito adopt.

On Windows, enable Developer Mode and see the Windows installation guide.

Prefer your coding agent set it up? (Click to expand prompt)

Paste this prompt into your coding agent:

Install and configure Aikito from https://github.com/lsaint/aikito. Read the README, src/aikito/templates/skills/aikito/SKILL.md, and any linked documentation relevant to the setup. Inspect the Agent configuration I already use, initialize the Aikito workspace, adopt supported existing resources, synchronize them through Aikito, and verify the result with aikito status. adopt and sync preflight their complete plans before writing. If either command stops, explain the findings and ask before using --skip, --force, --prune, or manually resolving a conflict. Preserve my current setup and do not register a project without my confirmation. If there is nothing to adopt, skip that step and tell me.

See the Result

aikito status shows synchronized context and durable memory across all agents and projects:

┌─────────────────┬───────┬────────┬────────┬─────────┬───────┬──────┬────────┐
│ Project         │ Instr │ Skills │ Memory │ Context │ Paths │ Mode │ Status │
├─────────────────┼───────┼────────┼────────┼─────────┼───────┼──────┼────────┤
│ aikito          │ 24L   │ 1      │ 12     │ ~3.5k   │ 2/3   │ link │ ✓      │
│ blog            │ –     │ 2      │ 8      │ ~3.0k   │ 0/1   │ link │ –      │
│ chat-distiller  │ 128L  │ 5      │ 14     │ ~8.2k   │ 1/1   │ link │ ✓      │
│ python-docx-oss │ 210L  │ 6      │ 21     │ ~12.4k  │ 1/1   │ copy │ ✓      │
└─────────────────┴───────┴────────┴────────┴─────────┴───────┴──────┴────────┘

Global: ✓ · Instr 24L · Skills 12 · Memory 6 · MCP 1 · Sub 3
Consumers (8): agy · claude · codex · copilot · dsh · grok · opencode · pi
All in one workspace: ~/aikito (AIKITO_DIR)

Prefer a browser view? Run aikito web for the local, read-only Console.

Why Aikito

AI agent resources fragment in three directions:

• Across tools: each agent invents its own folders, memory formats, and config conventions.
• Across projects: reusable knowledge, skills, and instructions are copied or drift out of sync.
• Across time: valuable decisions and hard-won lessons disappear into ephemeral chat sessions.

Aikito keeps the source files in one personal Git workspace and connects selected resources to each agent and project. No background daemon, vector store, database, or hosted service is required.

Durable Memory

The bundled durable-memory skill guides agents to retrieve relevant notes, record verified conclusions, and update stale knowledge. Notes are plain Markdown files versioned by Git.

• Global scope: cross-project preferences, coding conventions, and tool practices.
• Project scope: architecture decisions, API policies, and local workflows.

See memory usage and opt-out and why memory needs a maintainer.

Safety & Boundaries

Aikito is local-first and predictable by design:

• Preflight before write: adopt and sync simulate and check operations before modifying files.
• Respect existing work: a locally edited copied project skill blocks its sync until you review the difference; an unmanaged target is not silently claimed as Aikito's own.
• Plain files & Git: no background service, no proprietary database, no implicit prompt injection.
• You govern secrets: workspace is a local Git repository; review secrets before pushing.

Detailed safety and boundary references:

• Conflict handling & backups
• Design boundaries & comparisons

Documentation

Visit the full documentation site or dive into:

• Getting started: installation through adopting your existing setup.
• Workspace and synchronization: directory layout, scopes, and linking model.
• Aikito Cloud: account connection, automatic synchronization, and recovery.
• Connect another machine: multi-machine sync and custom paths.
• CLI reference: commands, options, and shell completion.
• Chat Distiller: distill browser AI chats into Markdown notes in your Inbox.
• Troubleshooting: resolving conflicts and synchronization drift.
• Remote protocol & self-hosting (optional): building custom private services or cloud sync backends.

Support

If you find Aikito useful, you can support its development.