Aiko

Agent-Aiko

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

Agent-Aiko でできること

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

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

---

どの版を選ぶか

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

3 版とも：

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

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

---

Aiko-MCP（MCP サーバー）

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

入れる

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

macOS / Linux:

AIKO_PACKAGE_DIR="$HOME/.local/share/aiko-mcp"

npm install --prefix "$AIKO_PACKAGE_DIR" --ignore-scripts --no-audit --no-fund aiko-mcp@0.3.8 node "$AIKO_PACKAGE_DIR/node_modules/aiko-mcp/dist/server.js" install

Windows PowerShell:

$AikoPackageDir = Join-Path $env:LOCALAPPDATA "aiko-mcp"

npm install --prefix $AikoPackageDir --ignore-scripts --no-audit --no-fund aiko-mcp@0.3.8 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-*）を取ります。

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

macOS / Linux:

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

Windows 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 を使ってください。

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

# 例。パスは自分の環境の 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 は書きません。

{

"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 を見るので、片方で覚えた呼び名はもう片方でも有効です。

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

---

クイックスタート

Claude Code 版

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

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

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

(

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 aiko-mcp@0.3.8 node "$work/node_modules/aiko-mcp/dist/maintenance.js" rollback )

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

& {

$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 aiko-mcp@0.3.8 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 を指定している場合はその保存先）を対象にします。保存先を別の利用者と共有していなければ、他の利用者の設定には影響しません。配布元のファイルも変更しません。

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 を新しいタグへ合わせてから出してください。

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

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

(

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 版

# 前提：Node.js 20+ ／ codex CLI ／ codex login 済

git clone https://github.com/masa-san-jp/Agent-Aiko.git cd Agent-Aiko bash codex/scripts/install.sh aiko # ~/.local/bin/aiko を PATH に通してから

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

Antigravity / Gemini CLI 版

# 前提：Node.js 20+ ／ Gemini CLI インストール済・認証済

git clone https://github.com/masa-san-jp/Agent-Aiko.git cd Agent-Aiko bash antigravity/scripts/install.sh gemini # 起動時に自動で Aiko コンテキストが注入される

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

Codex custom pet

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 新しい名前付き人格を作成して選択 /aiko-select 名前付き人格を選択（タイポ・大小揺れも 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| ] Claude の応答を音声読み上げ（TTS）するモードを制御する

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

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

/voice on       # 音声モード ON（macOS では say コマンドで即動作）

/voice off # 音声モード OFF /voice status # 現在の状態とエンジンを確認 /voice voicevox # エンジンを VOICEVOX に切替（VOICEVOX Engine が必要） /voice irodori # エンジンを Irodori-TTS-Server に切替 /voice avatar # デスクトップアバター表示と連動した読み上げ

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

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

bash .claude/scripts/aiko-boot.sh --daemon          # デーモンモード（全 OS）

bash .claude/scripts/aiko-boot.sh --daemon --telegram # Telegram ボットモードでデーモン起動 bash .claude/scripts/aiko-boot.sh --status bash .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/）も最初から使われてい