aikito
Your durable workspace across AI agents.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/lsaint/aikito with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/lsaint/aikito'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/lsaint--aikito)HTML
<a href="/listings/lsaint--aikito"><img src="/api/listings/lsaint--aikito/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
1. Install
With [uv](https://docs.astral.sh/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](docs/installation.md#install-manually).
<details> <summary><b>Prefer your coding agent set it up?</b> (Click to expand prompt)</summary>
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.
</details>
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 157 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <p align="center">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lsaint/aikito/main/docs/assets/logo-dark.png">
- <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/lsaint/aikito/main/docs/assets/logo-light.png">
- <img src="https://raw.githubusercontent.com/lsaint/aikito/main/docs/assets/logo-light.png" alt="Aikito Logo" width="160">
- </picture>
- </p>
- <h1 align="center">Aikito</h1>
- <p align="center">
- <b>Multi-Agent · Multi-Project · Multi-OS · Multi-Machine</b>
- </p>
- <p align="center">
- <a href="https://github.com/lsaint/aikito/releases"><img src="https://img.shields.io/github/v/release/lsaint/aikito" alt="Release"></a>
- <a href="https://github.com/lsaint/aikito/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/lsaint/aikito/ci.yml?branch=main&label=CI" alt="CI"></a>
- <a href="https://github.com/lsaint/aikito/blob/main/LICENSE"><img src="https://img.shields.io/github/license/lsaint/aikito" alt="License"></a>
- <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/Python-3.12%20%7C%203.13%20%7C%203.14-blue.svg" alt="Python 3.12 | 3.13 | 3.14"></a>
- <img src="https://img.shields.io/badge/dependencies-stdlib%20only-brightgreen.svg" alt="Dependencies: stdlib only">
- </p>
- <p align="center">
- <a href="README.zh-CN.md">简体中文</a> · <a href="https://lsaint.github.io/aikito/">Homepage</a> · <a href="https://lsaint.github.io/aikito/guide/">Documentation</a>
- </p>
- 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.
- <p align="center">
- <img src="https://raw.githubusercontent.com/lsaint/aikito/main/docs/assets/aikito-overview.png" alt="Aikito overview">
- </p>
- ## Quick Start
- ### 1. Install
- With [uv](https://docs.astral.sh/uv/) (recommended cross-platform) or Homebrew (macOS / Linux):
- ```bash
- 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:
- ```bash
- 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](docs/installation.md#install-manually).
- <details>
- <summary><b>Prefer your coding agent set it up?</b> (Click to expand prompt)</summary>
- 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.
- </details>
- ## See the Result
- `aikito status` shows synchronized context and durable memory across all agents and projects:
- ```text
- ┌─────────────────┬───────┬────────┬────────┬─────────┬───────┬──────┬────────┐
- │ 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`](docs/cli-reference.md#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](src/aikito/templates/skills/durable-memory/SKILL.md)
- 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](docs/durable-memory.md) and
- [why memory needs a maintainer](docs/programming-agent-memory.md).
- ## 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](docs/safety.md#conflict-and-drift-protection)
- - [Design boundaries & comparisons](docs/comparison.md)
- ## Documentation
- Visit the full [documentation site](https://lsaint.github.io/aikito/guide/) or dive into:
- - [Getting started](docs/guide.md): installation through adopting your existing setup.
- - [Workspace and synchronization](docs/architecture.md): directory layout, scopes, and linking model.
- - [Connect another machine](docs/workspace-portability.md): multi-machine sync and custom paths.
- - [CLI reference](docs/cli-reference.md): commands, options, and shell completion.
- - [Chat Distiller](docs/chat-distiller.md): distill browser AI chats into Markdown notes in your Inbox.
- - [Troubleshooting](docs/troubleshooting.md): resolving conflicts and synchronization drift.
- - [Aikito Cloud(optional)](docs/remote-sync.md): automatic synchronization, MCP client access, and recovery.
- - [Remote protocol & self-hosting (optional)](docs/architecture/remote-protocol.md): building custom private services or cloud sync backends.
- ## Support
- If you find Aikito useful, you can [support its development](https://lsaint.github.io/donation/?utm_source=github&utm_medium=readme&utm_campaign=aikito).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.