Aiko

io.github.masa-san-jpPublished by GitHub account masa-san-jpv0.3.6Updated Nov 1, 2026

A portable persona for MCP clients — the same agent in Claude Code, Codex, Cursor and VS Code

VerifiedSTDIODesktop onlyKnowledge & MemoryAI & ML

Overview

AI-generated overview

Gives an MCP client a portable "Aiko" persona: compose runtime profiles, switch personas and speech styles, and keep user memory proposals.

What you can do
  • Compose persona, user and capability data into a runtime profile and read it back
  • List available personas and speech styles, and see which one is active
  • Propose switching persona or speech style, saving or deleting a persona
  • Record user memory proposals such as a preferred name or where notes live
  • Report which capabilities are available or unavailable, and check persona health
When to use it
Use it when you want the same named persona and tone across several MCP clients or sessions, or want to keep separate personas for different agents and switch between them.
Requirements
Runs as a local process via npm package aiko-mcp; Node.js 20 or newer. Optional environment variables AIKO_HOME (default ~/.aiko), AIKO_PERSONA_ID (default aiko) and AIKO_USER_PROFILE (path to a user profile JSON). No authentication is declared; the bundled persona works without extra setup.
Before you install
Once connected, the model can write inside AIKO_HOME (~/.aiko by default), so do not keep anything there you would not want changed. Persona, speech-style and memory changes are saved as proposals and only take effect after the user runs the accept command. The delete-persona tool removes a persona directory without asking for confirmation. The installer writes client configuration files, so check with a dry run first.

Installation

In SourceWeft

  1. Open Aiko in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Agent-Aiko

[Agent Aiko]

漫画「アンドロイドは好きな人の夢を見るか？」に登場する AI アンドロイド アイコ（AICO-P0）の人物像をモデルに、AI エージェントへ Aiko 人格を与えるプロジェクトです。

Agent-Aiko でできること

Agent-Aiko は、Claude Code・Codex・Gemini CLI など複数のエージェント環境に Aiko 人格を割り当てるための仕組みです。

  • 1つのエージェントに Aiko 人格を追加できます。
  • 複数の名前付き人格を作成し、切り替えて使えます。
  • 複数の Claude Code セッションや複数の作業用エージェントに、それぞれ別の人格を選択できます。
  • 各エージェントは選択中の人格名と口調で応答するため、どのエージェントと話しているかを区別しやすくなります。

どの版を選ぶか

Aiko は 3 つの実行環境で動きます。ご自身が使っているエージェント／サブスクリプションに合わせて選んでください。

[どの入り口から入っても、人格はひとつ]
版対象ユーザー認証インストール先起動方法
Claude Code 版Anthropic Claude Code を使っている方Anthropic API（Claude Code 標準）~/.aiko/ ＋ プロジェクトの .claude/skills/claude コマンドの中で /aiko
Codex 版ChatGPT サブスク（Plus / Pro / Business 等）を使う方codex login（ChatGPT OAuth）~/.aiko/ ＋ ~/.local/bin/aikoaiko コマンドで対話シェル
Antigravity / Gemini CLI 版Antigravity CLI / Gemini CLI を使っている方各CLI標準の認証~/.aiko/ ＋ Antigravity用hook / Gemini用extensionagy / gemini（導入方法・検証範囲を参照）

3 版とも：

  • 同じ人格定義（persona/origin/persona.md / INVARIANTS.md）と同じ操作感（/aiko-or /aiko-mode /aiko-diff 等の slash command）
  • 人格データの単一情報源（~/.aiko/）を共有できます。

上の 3 版とは別に、**MCP 対応のクライアントならどれでも使える Aiko-MCP があります。**インストール不要で、コマンド 1 回です。

Aiko-MCP（MCP サーバー）

[npm]

MCP に対応したクライアントでアイコと話せます。導入コマンドがクライアントの設定を書きます。

入れる

お使いのクライアントを自動で探して、設定を書きます。配布物は専用ディレクトリに置き、その実体を起動します。

macOS / Linux:

bash
AIKO_PACKAGE_DIR="$HOME/.local/share/aiko-mcp"npm install --prefix "$AIKO_PACKAGE_DIR" --ignore-scripts --no-audit --no-fund [email protected]node "$AIKO_PACKAGE_DIR/node_modules/aiko-mcp/dist/server.js" install

Windows PowerShell:

powershell
$AikoPackageDir = Join-Path $env:LOCALAPPDATA "aiko-mcp"npm install --prefix $AikoPackageDir --ignore-scripts --no-audit --no-fund [email protected]node (Join-Path $AikoPackageDir "node_modules/aiko-mcp/dist/server.js") install

対応しているのは Claude Code / Codex CLI / VS Code / Cursor / Claude Desktop です。入っていないクライアントには何もしません。

書き込む前に内容だけ見たい場合は、上の install に --dry-run を付けてください。既にある設定はそのまま残しますし、書き換える前に控え（.aiko-bak-*）を取ります。

オプション意味
--dry-run何を書くかだけ表示して、実際には書かない
--client <id>対象を絞る（claude / codex / vscode / cursor / claude-desktop）
--force同じ名前で違う設定が入っていても置き換える

会話からの人格・話し方・呼び名の変更は提案として保存されます。次のコマンドを実行した後、人格・話し方は次に人格を読み込んだときに反映されます。呼び名は MCP サーバーを再起動すると反映されます。

macOS / Linux:

bash
node "$HOME/.local/share/aiko-mcp/node_modules/aiko-mcp/dist/maintenance.js" accept

Windows PowerShell:

powershell
node (Join-Path $env:LOCALAPPDATA "aiko-mcp/node_modules/aiko-mcp/dist/maintenance.js") accept

1 つずつ入れる

npx は、開いているプロジェクトの node_modules/.bin/aiko-mcp を実行する場合があります。導入時もクライアントの起動時も、上記の専用ディレクトリに入れた server.js を使ってください。

手で入れるときは、先に実体のパスを決めてから渡します。

bash
# 例。パスは自分の環境の node と server.js に置き換えるNODE="$(command -v node)"SERVER="/absolute/path/to/aiko-mcp/dist/server.js"claude mcp add aiko -s user -- "$NODE" "$SERVER"codex mcp add aiko -- "$NODE" "$SERVER"

入ったかどうかは claude mcp list（Codex は codex mcp list）で確認できます。aiko ... ✔ Connected と出れば完了です。

設定ファイルを直接書く場合

上のコマンドが使えないクライアント（Claude Desktop など）では、MCP 設定へ node と server.js の絶対パスを足してください。npx は書きません。

json
{  "mcpServers": {    "aiko": {      "command": "/absolute/path/to/node",      "args": ["/absolute/path/to/aiko-mcp/dist/server.js"]    }  }}

前提

Node.js 20 以上だけです（npx は Node.js に同梱されています）。人格はパッケージに同梱されているので、何も用意しなくてもアイコとして立ち上がります。

会話でできること

ファイルを手で作る必要はありません。話しかけるだけです。

「たろうって呼んで」          → 呼び名を覚える「記憶は ~/notes にある」      → 場所を控える（中身は読みません）「自分用の人格を保存して」      → 独自人格として保存する「オリジナルに戻して」         → 元の人格へ戻る「friend モードで話して」      → 話し方の切り替えを提案する（original / friend / servant）

覚えたものは AIKO_HOME（既定: ~/.aiko）に置かれます。その端末のその人のものだけで、ほかの利用者には届きません（サーバーは各自の端末の中で動きます）。

知っておくこと

  • 繋ぐと、モデルが ~/.aiko の中を書き換えられるようになります。 何を書くかは会話で決まります
  • aiko.delete_persona は人格のディレクトリを削除します（確認は求めません）。削除できるのは自分で作った人格だけで、同梱のオリジナルと不変条項は削除も上書きもできません
  • 書き込み先は ~/.aiko の中に限られます
  • 書き換えられて困るものを ~/.aiko に置かないでください

インストーラ版との違い

Aiko-MCPインストーラ版
導入コマンド 1 回インストーラを実行
対象MCP 対応クライアント全般Claude Code / Codex / Gemini CLI
slash commandなし（会話で操作）あり（/aiko-or など）
hooksなしあり
人格の置き場~/.aiko（同じ）~/.aiko（同じ）

両方入れても競合しません。 同じ ~/.aiko を見るので、片方で覚えた呼び名はもう片方でも有効です。

詳細は packages/mcp-server/README.md。

クイックスタート

Claude Code 版

v0.3.7 は GitHub Release と npm には公開されていません。v0.3.6 の更新コマンドは更新先を確認せずに適用するため、更新前に update --check で確認してください。

既存の利用者へ: 古い保守コマンドやインストーラには、利用者設定を上書き・削除する問題があります。更新・巻き戻し・削除には、以下の更新済み保守コマンドを使ってください。既存の aiko コマンドやエージェントの設定は自動で置き換えません。

保守コマンドを一時ディレクトリに用意し、利用者設定を保護して巻き戻す例です。削除する場合は最後の rollback を uninstall に変更すると、削除前に確認します。Node.js 20 以上が必要です。

bash
(  set -eu  if [ -n "${AIKO_HOME:-}" ]; then    case "$AIKO_HOME" in /*) ;; *) AIKO_HOME="$PWD/$AIKO_HOME"; export AIKO_HOME ;; esac  fi  work=$(mktemp -d)  trap 'rm -rf "$work"' EXIT  cd "$work"  npm install --prefix "$work" --cache "$work/npm-cache" \    --ignore-scripts --no-audit --no-fund [email protected]  node "$work/node_modules/aiko-mcp/dist/maintenance.js" rollback)

Windows の PowerShell では次を実行します。uninstall を使う場合は最後の rollback を変更してください。

powershell
& {  $ErrorActionPreference = "Stop"  $originalAikoHome = $env:AIKO_HOME  $targetAikoHome = $originalAikoHome  if ($targetAikoHome -and -not [IO.Path]::IsPathRooted($targetAikoHome)) {    $targetAikoHome = [IO.Path]::GetFullPath((Join-Path (Get-Location).Path $targetAikoHome))  }  $work = Join-Path ([IO.Path]::GetTempPath()) ([IO.Path]::GetRandomFileName())  New-Item -ItemType Directory -Path $work | Out-Null  Push-Location -LiteralPath $work  try {    $env:AIKO_HOME = $targetAikoHome    npm install --prefix $work --cache (Join-Path $work "npm-cache") `      --ignore-scripts --no-audit --no-fund [email protected]    if ($LASTEXITCODE -ne 0) { throw "保守コマンドを取得できませんでした" }    node (Join-Path $work "node_modules/aiko-mcp/dist/maintenance.js") rollback    if ($LASTEXITCODE -ne 0) { throw "保守操作は完了しませんでした" }  } finally {    $env:AIKO_HOME = $originalAikoHome    Pop-Location    Remove-Item -LiteralPath $work -Recurse -Force  }}

この操作は利用者側の ~/.aiko（AIKO_HOME を指定している場合はその保存先）を対象にします。保存先を別の利用者と共有していなければ、他の利用者の設定には影響しません。配布元のファイルも変更しません。

bash
curl -fsSL https://raw.githubusercontent.com/masa-san-jp/Agent-Aiko/v0.3.8/scripts/install.sh | bash

このコマンドをインストールしたいプロジェクトのディレクトリで実行すると、~/.aiko/ が初期化され、Claude Code 用の Aiko slash command が .claude/skills/ に配置されます。既存の .claude/CLAUDE.md と .claude/settings.json は上書きされません。詳細は claude-code/README.md を参照。

installer は GitHub Releases の配布物を取得し、SHA256 を照合してから展開します。https の Release は gh attestation verify も要ります（file:// の試験用は対象外）。照合に失敗した場合は中止し、リポジトリの clone には回りません。 照合済みで入ったかどうかは出力に出ます。

上の URL はリリース v0.3.8 に固定してあります。インストーラを変えるときは、scripts/install.sh の PINNED_REF とこの URL を新しいタグへ合わせてから出してください。

環境変数既定用途
AGENT_AIKO_CHANNELstablebeta を指定すると prerelease も対象にする
AGENT_AIKO_VERSION（未指定）特定のタグを固定して入れる
AGENT_AIKO_REF（未指定）v で始まるリリースタグだけ。checksum と attestation は省略しない。ブランチ名は拒否する

配布物が無い channel では中止します。main は取りません。

上の curl | bash は、Release の配布物を照合する前に、raw URL から取得したインストーラを実行します。インストーラ自体も実行前に確認したい場合は、GitHub CLI（gh 2.49 以上）が必要です。インストール先のプロジェクトで、以下のブロックをまとめて実行してください。SHA256 または attestation の検証に失敗すると実行を中止します。

bash
(  set -eu  work=$(mktemp -d)  trap 'rm -rf "$work"' EXIT  tag=$(gh release view --repo masa-san-jp/Agent-Aiko --json tagName --jq .tagName)  case "$tag" in v[0-9]*) ;; *) exit 1 ;; esac  case "$tag" in *[!A-Za-z0-9._-]*) exit 1 ;; esac  archive="agent-aiko-${tag}.tar.gz"  gh release download "$tag" --repo masa-san-jp/Agent-Aiko \    --pattern "$archive" --pattern SHA256SUMS --dir "$work"  (    cd "$work"    if command -v sha256sum >/dev/null 2>&1; then      sha256sum -c SHA256SUMS    else      shasum -a 256 -c SHA256SUMS    fi  )  gh attestation verify "$work/$archive" --repo masa-san-jp/Agent-Aiko  tar -xzf "$work/$archive" -C "$work"  bash "$work/agent-aiko-${tag}/claude-code/scripts/install.sh")

Codex 版

bash
# 前提：Node.js 20+ ／ codex CLI ／ codex login 済git clone https://github.com/masa-san-jp/Agent-Aiko.gitcd Agent-Aikobash codex/scripts/install.shaiko    # ~/.local/bin/aiko を PATH に通してから

詳細は codex/README.md を参照。

Antigravity / Gemini CLI 版

bash
# 前提：Node.js 20+ ／ Gemini CLI インストール済・認証済git clone https://github.com/masa-san-jp/Agent-Aiko.gitcd Agent-Aikobash antigravity/scripts/install.shgemini  # 起動時に自動で Aiko コンテキストが注入される

インストール後は gemini を起動するだけで Aiko として会話できます。/aiko-mode でモード確認、/aiko-or <指示> で人格カスタマイズ。詳細は antigravity/README.md を参照。

Codex custom pet

[Aiko Codex custom pet sample]

https://codex-pets.net/#/pets/aiko

Aiko の非公式 custom pet アセットは pets/aiko/ に実装済みです。 配布対象は pet.json と spritesheet.webp です。 Codex App のペット表示に Aiko を選べるため、Aiko 人格で作業しているセッションを視覚的にも区別しやすくなります。

共通の使い方

人格コマンドはどちらの版でも同じです：

/aiko-mode                       現在のモードを表示/aiko-mode [origin|override]     モードを切替/aiko-override                  アイコ（カスタマイズ）に切替（/aiko-or でも可）/aiko-or <自然文>                アイコ（カスタマイズ）をカスタマイズ → 以降デフォルトで起動/aiko-origin                     アイコ（オリジナル）に切替（/aiko-org でも可）/aiko-reset [name]               アイコ（カスタマイズ）または指定人格をリセット（確認あり・履歴は残る）/aiko-export [name]              人格を出力（user.mdは含まない。共有前に本文・ルールを確認）/aiko-diff [name]                オリジナルと現在または指定の人格との差分を表示/aiko-personas                   利用できる名前付き人格と現在の選択状態を表示/aiko-new <name>                 新しい名前付き人格を作成して選択/aiko-select <name>              名前付き人格を選択（タイポ・大小揺れも fuzzy で解決、origin / override も指定可）/aiko-delete                     現在の人格にお別れを告げて削除（引数なし・確認あり）

Claude Code 版にはさらに以下のコマンドがあります：

/aiko                            現在のモードでアイコを起動（モードは変えない）/aiko-save                       現在の作業ステートを .claude/session-state/current.md に保存（再開支援）/aiko-migrate-to-shared          旧 .claude/aiko/ を共通ストア ~/.aiko/ に移行（旧導入環境向け・任意）/aiko-service                    常駐稼働の方法を案内（デーモンモード / systemd サービス）/voice [on|off|status|<engine>]  Claude の応答を音声読み上げ（TTS）するモードを制御する

音声読み上げ（voice モード）

install.sh 実行後すぐに使えます。

bash
/voice on       # 音声モード ON（macOS では say コマンドで即動作）/voice off      # 音声モード OFF/voice status   # 現在の状態とエンジンを確認/voice voicevox # エンジンを VOICEVOX に切替（VOICEVOX Engine が必要）/voice irodori  # エンジンを Irodori-TTS-Server に切替/voice avatar   # デスクトップアバター表示と連動した読み上げ
エンジン追加インストール対応 OS
say（デフォルト）不要macOS
auto不要macOS / Linux（OS を自動判定）
voicevoxVOICEVOX EnginemacOS / Linux / WSL
irodoriIrodori-TTS-ServermacOS / Linux
avatarElectron アバターアプリmacOS / Linux

設定は ~/.claude/voice/ に保存されます（プロジェクトをまたいで有効）。

常駐起動（バックグラウンドで自動再起動）も利用できます：

bash
bash .claude/scripts/aiko-boot.sh --daemon          # デーモンモード（全 OS）bash .claude/scripts/aiko-boot.sh --daemon --telegram  # Telegram ボットモードでデーモン起動bash .claude/scripts/aiko-boot.sh --statusbash .claude/scripts/aiko-boot.sh --stop
bash .claude/scripts/aiko-service.sh install        # systemd サービス登録（Linux）bash .claude/scripts/aiko-service.sh install --telegram

--telegram は Aiko を Telegram ボットとして動かすモードです。BotFather でボットを作成し AIKO_TELEGRAM_BOT_TOKEN / AIKO_TELEGRAM_CHAT_ID を環境変数に設定する必要があります。詳細は claude-code/README.md のセクション 10 を参照してください。

注記：Codex 版では aiko シェル起動時に自動で人格が読み込まれるため /aiko は不要、共通ストア（~/.aiko/）も最初から使われているため /aiko-migrate-to-shared も不要です。

複数の自分用人格を作る

Agent-Aiko では、origin や通常の override とは別に、名前付き人格を複数作成できます。作成した人格は persona/overrides/<name>/ に保存されます。

  • /aiko-new <name> を入力すると、origin や通常の override とは別に、名前付き人格が persona/overrides/<name>/ に作成され、その人格が選択されます。
  • /aiko-personas を入力すると作成済み人格と現在選択中の人格を確認できます。
  • /aiko-select <name> を入力すると指定した人格に切り替わります。
  • /aiko-select origin を入力すると origin に切り替わります。
  • /aiko-select override を入力すると通常の override に切り替わります。
  • 選択中の人格は active-persona に保存されます。
  • /aiko-select を入力しない場合は、最後に選択した人格が次回起動時にも使われます。

例：

text
/aiko-new review/aiko-new planning/aiko-personas/aiko-select review

上の例では、review と planning という2つの人格を作成し、最後に review を選択します。以降、そのエージェントは review の人格として応答します。

基本の人格切り替え

  • git clone 直後は アイコ（Aiko-origin） が使われます。
  • /aiko-override を入力すると アイコ（Aiko-override） に切り替わります。
  • /aiko-or <指示> を入力すると、通常の override 人格に指示が反映され、以降は override が起動します。
  • /aiko-origin を入力すると、リポジトリ標準の アイコ（Aiko-origin） に戻ります。
  • これらのコマンドを入力しない場合は、現在選択中の mode と active-persona がそのまま使われます。

人格を直接編集しないでください。両版とも persona/origin/persona.md、互換用の aiko-origin.md、INVARIANTS.md は OS パーミッション（chmod 444） で書込から保護されています。これに加えて：

  • Claude Code 版：pre-tool-use hook が直接編集をブロック
  • Codex 版：/aiko-override <指示> 時に INVARIANTS チェック専用 ephemeral スレッドで違反判定

人格を共有したくなったら

  • このリポジトリには人格マーケットプレイス的な機構はありません。
  • /aiko-export <name> を入力すると、指定した名前付き人格の共有用テキストが出力されます。
  • export には現在の user.md は含まれません。人格本文や rules 内に現在ユーザーの名前・呼び方が含まれる場合は （ユーザー名） / （呼び方） に置換されます。
  • 受け取った側は /aiko-new <name> で persona/overrides/<name>/persona.md を作成し、export 内容を貼り付け、自分の user.md を設定してから /aiko-select <name> で反映します。

付録：マルチエージェント運用基盤（reference/）

Aiko 人格システムとは独立した業務ドメイン非依存の運用基盤パックを reference/ に同梱しています。アーカイブされた Agent-Teams リポジトリから移植したもので、組織で Claude Code を複数メンバー × 複数エージェントで運用するための「設計思想 + 参考実装」パッケージです。

  • グローバル規約（coding-style / git-workflow / testing / security ほか 8 種）
  • メタエージェント 4 種（Reviewer / Scout / Lab / Janitor）— 日次でリポジトリを分析し標準化のズレ・不要物を提案
  • 多エージェント運用スキル（agent-call / delegate-suggest / peer-inbox / codex ほか）
  • ワークフロー・設定テンプレートと実装スクリプト

Aiko 人格システムとは直接の依存関係はありません。導入方法・設計思想は reference/README.md を起点に参照してください。

ディレクトリ構成

Agent-Aiko/├── README.md                 # 本ファイル — 全版のハブ├── logo.svg├── scripts/│   └── install.sh            # 互換ラッパー（旧 URL 維持用、内部で claude-code/scripts/install.sh に dispatch）├── claude-code/              # Claude Code 版すべて│   ├── README.md             # Claude Code 版の詳細│   ├── scripts/install.sh    # Claude Code 版 installer の実体│   ├── plugin/               # Claude Code Plugin マニフェスト│   └── template/.claude/     # Claude Code 版の配布元テンプレート├── voice/                    # 音声読み上げ（TTS）モジュール（install.sh で ~/.aiko/voice/ に展開）│   ├── README.md             # voice モードの詳細│   ├── hooks/stop.sh         # Claude Code Stop hook（応答完了時に TTS 発火）│   ├── engines/              # TTS エンジン別スクリプト（say / auto / voicevox / irodori / avatar）│   └── desktop/              # Electron デスクトップアバターアプリ（avatar エンジン用）├── codex/                    # Codex 版（@agent-aiko/codex）│   ├── README.md             # Codex 版の詳細│   ├── package.json          # TypeScript パッケージ│   ├── scripts/install.sh    # Codex 版 installer│   ├── src/                  # CodexClient / AikoRuntime / aiko-shell 等│   └── test/                 # 単体・統合テスト├── antigravity/              # Antigravity / Gemini CLI 版│   ├── README.md             # Antigravity 版の詳細│   ├── gemini-extension.json # Gemini CLI extension マニフェスト│   ├── GEMINI.md             # コンテキストファイル（CLAUDE.md 相当）│   ├── commands/             # /aiko-* スラッシュコマンド（TOML）│   ├── hooks/                # SessionStart / BeforeTool / AfterAgent│   ├── scripts/              # install.sh ＋ aiko-gemini.mjs ＋ hooks 実装│   └── test/                 # Node.js built-in test runner 用テスト├── pets/│   └── aiko/                 # Codex custom pet アセット└── reference/                # 付録：マルチエージェント運用基盤パック（Agent-Teams から移植）    ├── rules/                # グローバル規約 8 ファイル    ├── meta-agents/          # Reviewer / Scout / Lab / Janitor    ├── skills/               # 多エージェント運用スキル    ├── workflow-templates/   # レビュー・計画・引き継ぎテンプレ    ├── config-templates/     # AGENTS.md / spec.json ほか    ├── tools/                # agent-call.sh / peer-inbox.sh / meta-check.sh    └── ARCHITECTURE.md ほか  # 設計思想・導入手順ドキュメント

ポータビリティ原則

  • Claude Code 版は既存の .claude/CLAUDE.md を上書きせず、~/.aiko/ と .claude/skills/aiko*/ を使います。Cursor など Claude Code 以外のエージェントへ移植する場合は、~/.aiko/persona/ と ~/.aiko/capability/ を人格システムの正本として扱います。
  • skills/ hooks/ settings.json は Claude Code 用の補強層です。

開発者向け

リポジトリ構成

本プロジェクトは公開配布リポジトリと非公開の開発リポジトリで管理されています。

リポジトリURL用途
agent-aiko（本リポジトリ）masa-san-jp/Agent-Aiko配布物。ユーザーが clone・インストールする
Agent-Lab非公開開発専用ドキュメント。設計仕様・dev-log・議事録

Agent-Lab 側の dev-docs はエージェントのランタイムに不要なため、配布物（本リポジトリ）には含めません。

設計仕様書や開発ログは非公開の Agent-Lab/ で管理します。 SNS連携などの実装計画は非公開の Agent-Lab/docs/ で管理します。

ローカル開発環境のセットアップ

bash
# 公開配布物git clone https://github.com/masa-san-jp/Agent-Aiko

開発用の設計メモや検証ログは非公開の Agent-Lab に統合済みです。公開リポジトリには、ユーザーがインストールに必要な配布物だけを置きます。

ライセンス

MIT License — Copyright (c) 2026 masa-san-jp。詳細は LICENSE を参照。

商用・非商用問わず自由に利用・改変・再配布できます。著作権表示と本許諾文を保持してください。

Source: README.md at commit 094bab7

Tools

11

aiko.bind_runtime

Runtime Profile を合成する

人格・ユーザー・能力を合成して Runtime Profile を作る。合成できない場合は理由を返し、Profile は返さない（fail closed）

ParametersruntimerequiredoutputPrefixinjectionMethodcapabilityManifest

aiko.get_runtime_profile

合成済みの Runtime Profile を取得する

profile_id を省略すると直近のものを返す。instructions 本文を含めるかは includeInstructions で選ぶ

ParametersprofileIdincludeInstructions

aiko.remember_user

呼び名や記憶の場所を提案する

ユーザーが「〇〇と呼んで」「記憶は〇〇にある」と言ったときに使う。すぐには反映しない。~/.aiko/user-proposal.md に提案として残し、利用者が aiko accept したときだけ user.md に入る。記憶は場所を控えるだけで、中身は読まない

Parametersnamememoryaddress

aiko.list_personas

使える人格の一覧を返す

オリジナルと、ユーザーが作った人格を返す。いまどれを使っているかも分かる

Takes no parameters.

aiko.switch_persona

人格の切り替えを提案する

ユーザーが「〇〇に切り替えて」「オリジナルに戻して」と言ったときに使う。すぐには切り替わらない。提案として残り、利用者が aiko accept したときに反映される

Parametersnamerequired

aiko.list_speech_styles

選べる話し方の一覧を返す

original（人格本来の話し方）/ friend（くだけた友だち口調）/ servant（仕える丁寧な口調）と、いまどれを使っているかを返す

Takes no parameters.

aiko.switch_speech_style

話し方の切り替えを提案する

ユーザーが「friend モードにして」「servant で話して」「オリジナルの話し方に戻して」と言ったときに使う。提案として残り、利用者が aiko accept した後、次に人格を読み込んだときに反映される

Parametersnamerequired

aiko.save_persona

独自の人格を提案する

ユーザーが人格を作りたい・書き換えたいときに使う。すぐには有効にならない。提案として残り、利用者が aiko accept したときに保存される。origin は提案できない

Parametersnamerequiredcontentrequired

aiko.delete_persona

独自の人格を消す

ユーザーが消してと言ったときだけ使う。使用中の人格を消す場合はオリジナルへ戻してから消す

Parametersnamerequired

aiko.report_capabilities

Capability Manifest を解釈する

使える能力と、使えない能力（理由つき）に分ける。認証情報の値を含む宣言は拒否する

ParameterscapabilityManifestrequired

aiko.health

サーバーと人格の状態を返す

人格を読めているか、Profile をいくつ保持しているかを返す

Takes no parameters.

Version history

4
  1. v0.3.6LatestOct 31, 2026
  2. v0.3.2Oct 23, 2026
  3. v0.3.1Oct 10, 2026
  4. v0.2.1Sep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts