Skip to content
Back to search

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/lsaint--aikito/badge.svg)](/listings/lsaint--aikito)

HTML

<a href="/listings/lsaint--aikito"><img src="/api/listings/lsaint--aikito/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

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.

  1. <p align="center">
  2. <picture>
  3. <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/lsaint/aikito/main/docs/assets/logo-dark.png">
  4. <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/lsaint/aikito/main/docs/assets/logo-light.png">
  5. <img src="https://raw.githubusercontent.com/lsaint/aikito/main/docs/assets/logo-light.png" alt="Aikito Logo" width="160">
  6. </picture>
  7. </p>
  8. <h1 align="center">Aikito</h1>
  9. <p align="center">
  10. <b>Multi-Agent · Multi-Project · Multi-OS · Multi-Machine</b>
  11. </p>
  12. <p align="center">
  13. <a href="https://github.com/lsaint/aikito/releases"><img src="https://img.shields.io/github/v/release/lsaint/aikito" alt="Release"></a>
  14. <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>
  15. <a href="https://github.com/lsaint/aikito/blob/main/LICENSE"><img src="https://img.shields.io/github/license/lsaint/aikito" alt="License"></a>
  16. <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>
  17. <img src="https://img.shields.io/badge/dependencies-stdlib%20only-brightgreen.svg" alt="Dependencies: stdlib only">
  18. </p>
  19. <p align="center">
  20. <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>
  21. </p>
  22. Aikito gives you one place to govern the context your coding agents share.
  23. Manage instructions, skills, MCPs, subagents, and durable memory across agents, projects, and machines.
  24. <p align="center">
  25. <img src="https://raw.githubusercontent.com/lsaint/aikito/main/docs/assets/aikito-overview.png" alt="Aikito overview">
  26. </p>
  27. ## Quick Start
  28. ### 1. Install
  29. With [uv](https://docs.astral.sh/uv/) (recommended cross-platform) or Homebrew (macOS / Linux):
  30. ```bash
  31. uv tool install aikito
  32. # or: brew install lsaint/tap/aikito
  33. ```
  34. ### 2. Set Up Your Workspace
  35. Bring your existing Agent setup under Aikito in 30 seconds:
  36. ```bash
  37. aikito init workspace ~/aikito
  38. aikito adopt # use --dry-run to preview, --verbose for full paths
  39. aikito sync
  40. aikito status
  41. ```
  42. `adopt` and `sync` preflight their complete plans before writing. Starting from
  43. scratch? Simply skip `aikito adopt`.
  44. > On Windows, enable Developer Mode and see the [Windows installation guide](docs/installation.md#install-manually).
  45. <details>
  46. <summary><b>Prefer your coding agent set it up?</b> (Click to expand prompt)</summary>
  47. Paste this prompt into your coding agent:
  48. > Install and configure Aikito from https://github.com/lsaint/aikito. Read the
  49. > README, `src/aikito/templates/skills/aikito/SKILL.md`, and any linked
  50. > documentation relevant to the setup. Inspect the Agent configuration I
  51. > already use, initialize the Aikito workspace, adopt supported existing resources,
  52. > synchronize them through Aikito, and verify the result with `aikito status`.
  53. > `adopt` and `sync` preflight their complete plans before writing. If either
  54. > command stops, explain the findings and ask before using `--skip`, `--force`,
  55. > `--prune`, or manually resolving a conflict. Preserve my current setup and do
  56. > not register a project without my confirmation. If there is nothing to adopt,
  57. > skip that step and tell me.
  58. </details>
  59. ## See the Result
  60. `aikito status` shows synchronized context and durable memory across all agents and projects:
  61. ```text
  62. ┌─────────────────┬───────┬────────┬────────┬─────────┬───────┬──────┬────────┐
  63. │ Project │ Instr │ Skills │ Memory │ Context │ Paths │ Mode │ Status │
  64. ├─────────────────┼───────┼────────┼────────┼─────────┼───────┼──────┼────────┤
  65. │ aikito │ 24L │ 1 │ 12 │ ~3.5k │ 2/3 │ link │ ✓ │
  66. │ blog │ – │ 2 │ 8 │ ~3.0k │ 0/1 │ link │ – │
  67. │ chat-distiller │ 128L │ 5 │ 14 │ ~8.2k │ 1/1 │ link │ ✓ │
  68. │ python-docx-oss │ 210L │ 6 │ 21 │ ~12.4k │ 1/1 │ copy │ ✓ │
  69. └─────────────────┴───────┴────────┴────────┴─────────┴───────┴──────┴────────┘
  70. Global: ✓ · Instr 24L · Skills 12 · Memory 6 · MCP 1 · Sub 3
  71. Consumers (8): agy · claude · codex · copilot · dsh · grok · opencode · pi
  72. All in one workspace: ~/aikito (AIKITO_DIR)
  73. ```
  74. Prefer a browser view? Run [`aikito web`](docs/cli-reference.md#aikito-web) for
  75. the local, read-only Console.
  76. ## Why Aikito
  77. AI agent resources fragment in three directions:
  78. - **Across tools**: each agent invents its own folders, memory formats, and config conventions.
  79. - **Across projects**: reusable knowledge, skills, and instructions are copied or drift out of sync.
  80. - **Across time**: valuable decisions and hard-won lessons disappear into ephemeral chat sessions.
  81. Aikito keeps the source files in one personal Git workspace and connects
  82. selected resources to each agent and project. No background daemon, vector store,
  83. database, or hosted service is required.
  84. ### Durable Memory
  85. The bundled [durable-memory skill](src/aikito/templates/skills/durable-memory/SKILL.md)
  86. guides agents to retrieve relevant notes, record verified conclusions, and
  87. update stale knowledge. Notes are plain Markdown files versioned by Git.
  88. - **Global scope**: cross-project preferences, coding conventions, and tool practices.
  89. - **Project scope**: architecture decisions, API policies, and local workflows.
  90. See [memory usage and opt-out](docs/durable-memory.md) and
  91. [why memory needs a maintainer](docs/programming-agent-memory.md).
  92. ## Safety & Boundaries
  93. Aikito is local-first and predictable by design:
  94. - **Preflight before write**: `adopt` and `sync` simulate and check operations before modifying files.
  95. - **Respect existing work**: a locally edited copied project skill blocks its
  96. sync until you review the difference; an unmanaged target is not silently
  97. claimed as Aikito's own.
  98. - **Plain files & Git**: no background service, no proprietary database, no implicit prompt injection.
  99. - **You govern secrets**: workspace is a local Git repository; review secrets before pushing.
  100. Detailed safety and boundary references:
  101. - [Conflict handling & backups](docs/safety.md#conflict-and-drift-protection)
  102. - [Design boundaries & comparisons](docs/comparison.md)
  103. ## Documentation
  104. Visit the full [documentation site](https://lsaint.github.io/aikito/guide/) or dive into:
  105. - [Getting started](docs/guide.md): installation through adopting your existing setup.
  106. - [Workspace and synchronization](docs/architecture.md): directory layout, scopes, and linking model.
  107. - [Connect another machine](docs/workspace-portability.md): multi-machine sync and custom paths.
  108. - [CLI reference](docs/cli-reference.md): commands, options, and shell completion.
  109. - [Chat Distiller](docs/chat-distiller.md): distill browser AI chats into Markdown notes in your Inbox.
  110. - [Troubleshooting](docs/troubleshooting.md): resolving conflicts and synchronization drift.
  111. - [Aikito Cloud(optional)](docs/remote-sync.md): automatic synchronization, MCP client access, and recovery.
  112. - [Remote protocol & self-hosting (optional)](docs/architecture/remote-protocol.md): building custom private services or cloud sync backends.
  113. ## Support
  114. 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 in

Free to use. If it’s helped, pass it on.