**Show HN：** *Axe ― 12 MB のバイナリで、あなたの AI フレームワークを置き換える*

LLM駆動型エージェントを管理・実行するCLIツール

なぜ Axe なのか？

多くの AI ツールは「チャットボット」を想定しています。
大容量のコンテキストウィンドウで長時間にわたる対話を一度に処理できるような設計です。
しかし、良いソフトウェアとは小さく、特化し、組み合わせやすいものです。

• Axe は LLM エージェントを Unix のプログラムと同じ扱いにします。
  • 各エージェントは「一つのこと」を得意とする。
    • TOML ファイルで定義。
    • 集中したスキルを持たせる。
    • コマンドラインから実行。
• データをパイプして入力し、結果を出力 します。
• エージェント同士をチェーンに接続し、cron・git フック・CI などからトリガーできます。

デーモンも GUI もフレームワークも不要です。
バイナリと設定ファイルだけで完結します。

概要

Axe は TOML 設定ファイルで定義された LLM 駆動型エージェントをオーケストレーションします。
各エージェントは以下の属性を持ちます：

• system prompt
• モデル選択
• スキルファイル
• コンテキストファイル
• 作業ディレクトリ
• 永続メモリ
• サブエージェントへの委譲

Axe は実行者であり、スケジューラではありません。
標準 Unix ツール（cron・git フック・パイプ・ファイル監視）と組み合わせて使用するよう設計されています。

主な機能

• マルチプロバイダー対応 – Anthropic、OpenAI、Ollama（ローカルモデル）
• TOML ベースのエージェント設定 – 宣言的でバージョン管理可能
• サブエージェント委譲 – LLM のツール呼び出し経由で他エージェントを起動；深さ制限と並列実行
• 永続メモリ – タイムスタンプ付き Markdown ログにより、実行間のコンテキスト保持
• メモリ GC – LLM を使ったパターン分析で不要データを削除
• スキルシステム – 複数エージェントで共有可能な再利用指示セット
• stdin パイピング – 任意の出力を直接エージェントへ渡す
  (

  git diff | axe run reviewer

  )
• ドライランモード – LLM を呼び出さずに解決済みコンテキストを確認
• JSON 出力 – スクリプト向けメタデータ付き構造化出力
• ビルトインツール – ファイル操作（読み込み・書き込み・編集・一覧）、シェルコマンド実行；エージェントの作業ディレクトリにサンドボックス化
• 最小依存関係 – 直接依存は

  cobra

  と

  toml

  のみ。全ての LLM 呼び出しは標準ライブラリ経由

インストール

Go 1.24+ が必要です。

go install github.com/jrswab/axe@latest

またはソースからビルド：

git clone https://github.com/jrswab/axe.git
cd axe
go build .

クイックスタート

設定ディレクトリを初期化

axe config init

$XDG_CONFIG_HOME/axe/

config.toml

新規エージェントの scaffold

axe agents init my-agent

設定ファイルを編集：

axe agents edit my-agent

実行：

axe run my-agent

他ツールから入力をパイプ：

git diff --cached | axe run pr-reviewer
cat error.log | axe run log-analyzer

例

examples/

cp examples/code-reviewer/code-reviewer.toml "$(axe config path)/agents/"
cp -r examples/code-reviewer/skills/ "$(axe config path)/skills/"

API キーを設定し、実行：

export ANTHROPIC_API_KEY="your-key-here"
git diff | axe run code-reviewer

examples/README.md

Docker

Axe は隔離済みハード化コンテナでエージェントを実行できます。

イメージビルド

マルチアーキ（linux/amd64, linux/arm64）対応は buildx で：

docker buildx build --platform linux/amd64,linux/arm64 -t axe:latest .

エージェント実行

設定ディレクトリをマウントし、API キーを環境変数に渡します。

docker run --rm \
  -v ./my-config:/home/axe/.config/axe \
  -e ANTHROPIC_API_KEY \
  axe run my-agent

stdin をパイプするには

-i

git diff | docker run --rm -i \
  -v ./my-config:/home/axe/.config/axe \
  -e ANTHROPIC_API_KEY \
  axe run pr-reviewer

設定ボリュームをマウントしないと、Axe はコード 2（設定エラー）で終了します。
（エージェント TOML ファイルが存在しないため）

単一エージェント実行

必要なファイルだけをマウント：

docker run --rm -i \
  -e ANTHROPIC_API_KEY \
  -v ./agents/reviewer.toml:/home/axe/.config/axe/agents/reviewer.toml:ro \
  -v ./skills/code-review/:/home/axe/.config/axe/skills/code-review/:ro \
  axe run reviewer

スキルを上書きしたい場合：

docker run --rm -i \
  -e ANTHROPIC_API_KEY \
  -v ./agents/reviewer.toml:/home/axe/.config/axe/agents/reviewer.toml:ro \
  -v ./alt-review.md:/home/axe/alt-review.md:ro \
  axe run reviewer --skill /home/axe/alt-review.md

エージェントが

sub_agents

永続データ

メモリ永続化にはボリュームをマウント：

docker run --rm \
  -v ./my-config:/home/axe/.config/axe \
  -v axe-data:/home/axe/.local/share/axe \
  -e ANTHROPIC_API_KEY \
  axe run my-agent

Docker Compose

ローカル Ollama インスタンスと一緒に Axe を実行するための

docker-compose.yml

# クラウドのみ（Ollama 未使用）
docker compose run --rm axe run my-agent

# Ollama サイドカー付き
docker compose --profile ollama up -d ollama
docker compose --profile cli run --rm axe run my-agent

Ollama モデルをプル：

docker compose --profile ollama exec ollama ollama pull llama3

注意
Compose の Axe サービスは

depends_on: ollama

を宣言しています。
そのため、クラウドのみの実行でも Compose で起動すると Ollama が自動的に開始されます。
クラウド専用の場合は

docker run

を直接使用してください。

ホスト上の Ollama

Ollama がホスト側で直接稼働している場合、以下のように接続します。

# Linux
--add-host=host.docker.internal:host-gateway -e AXE_OLLAMA_BASE_URL=http://host-docker.internal:11434

# macOS / Windows (Docker Desktop)
-e AXE_OLLAMA_BASE_URL=http://host.docker.internal:11434

セキュリティ

コンテナはデフォルトで以下のハードニングを行います（Compose で）。

/tmp/axe

cap_drop: ALL

no-new-privileges:true

これらの設定はアウトバウンドネットワークアクセスを制限しません。
ローカル Ollama のみと通信するエージェントを隔離したい場合は

--network=none

/home/axe/.config/axe/

/home/axe/.local/share/axe/

設定は読み書き可能です。

axe config init

axe agents init

:ro

環境変数

ANTHROPIC_API_KEY

OPENAI_API_KEY

AXE_OLLAMA_BASE_URL

AXE_ANTHROPIC_BASE_URL

AXE_OPENAI_BASE_URL

CLI 参照

コマンド一覧

axe run <agent>

axe agents list

axe agents show <agent>

axe agents init <agent>

axe agents edit <agent>

$EDITOR

axe config path

axe config init

axe gc <agent>

axe gc --all

axe version

フラグ

--model <provider/model>

anthropic/claude-sonnet-4-20250514

--skill <path>

--workdir <path>

--timeout <seconds>

--dry-run

--verbose / -v

--json

エージェント設定

エージェントは

$XDG_CONFIG_HOME/axe/agents/

name = "pr-reviewer"
description = "Pull request を問題と改善点をレビューします。"
model = "anthropic/claude-sonnet-4-20250514"
system_prompt = "あなたはシニアコードレビュワーです。簡潔で実用的に回答してください。"
skill = "skills/code-review/SKILL.md"
files = ["src/**/*.go", "CONTRIBUTING.md"]
workdir = "/home/user/projects/myapp"
tools = ["read_file", "list_directory", "run_command"]
sub_agents = ["test-runner", "lint-checker"]

[sub_agents_config]
max_depth = 3       # 最大ネスト深度（硬直最大：5）
parallel = true     # サブエージェントを同時実行
timeout = 120       # サブエージェント単位のタイムアウト

[memory]
enabled = true
last_n = 10         # コンテキストにロードする最後の N エントリ
max_entries = 100   # 超過警告

[params]
temperature = 0.3
max_tokens = 4096

name

model

ツール

エージェントはビルトインツールを使ってファイルシステムやコマンドを操作できます。
ツールが有効になると、LLM は対話ループに入り、ツール呼び出し結果を受け取り最大 50 ターンで推論を継続します。

list_directory

read_file

write_file

edit_file

run_command

sh -c

call_agent

sub_agents

パスセキュリティ：
すべてのファイルツールはエージェントの作業ディレクトリにサンドボックス化されます。絶対パス、

..

並列実行

LLM が単一ターンで複数ツール呼び出しを返す場合、デフォルトでは同時に実行します（ビルトインツールとサブエージェント呼び出しの両方）。

[sub_agents_config]

parallel = false

スキル

スキルは再利用可能な指示セットで、ドメイン固有の知識とワークフローをエージェントに提供します。

SKILL.md

スキル解決

エージェント TOML の

skill

1. 絶対パス – そのまま使用（例：

   /home/user/skills/SKILL.md

   ）
2. 設定ディレクトリ相対 –

   skills/code-review/SKILL.md

   は

   $XDG_CONFIG_HOME/axe/skills/code-review/SKILL.md

   に解決
3. 単一名 –

   code-review

   は

   $XDG_CONFIG_HOME/axe/skills/code-review/SKILL.md

スクリプトパス

スキルはしばしばヘルパースクリプトを参照します。

run_command

SKILL.md

# 正しい — 絶対パス
/home/user/.config/axe/skills/my-skill/scripts/fetch.sh <args>

# 間違い — 相対パスは作業ディレクトリから解決されず失敗
scripts/fetch.sh <args>

ディレクトリ構成

$XDG_CONFIG_HOME/axe/
├── config.toml
├── agents/
│   └── my-agent.toml
└── skills/
    └── my-skill/
        ├── SKILL.md
        └── scripts/
            └── fetch.sh

プロバイダー

ANTHROPIC_API_KEY

OPENAI_API_KEY

ベース URL は

AXE_<PROVIDER>_BASE_URL

config.toml

ライセンス

Apache‑2.0 – 詳細は LICENSE をご確認ください。