Show HN: Aict – AIエージェント向けに構築された、XML/JSONを出力するUnixコアユーティリティ
Show HN: Aict – Unix coreutils that output XML/JSON, built for AI agents (github.com)
要約
aictは、33のUnixコアユーティリティを再実装し、AIエージェントが直接読み取れるXMLまたはJSON形式で構造化されたデータを出力するツールです。これにより、AIエージェントは人間が読めるプレーンテキストを解析する際のトークン消費や処理の脆弱性を回避できます。aictは、ファイルサイズ、言語、MIMEタイプなどの詳細情報を付与し、AIのタスク実行効率と精度を向上させます。
全文翻訳
[画像: aict]
AIエージェント向けに構築された、XML/JSONを出力するUnix coreutils。人間向けではない。
[画像: CI] [画像: Go 1.25] [画像: Release] [画像: Go Report Card] [画像: License: MIT] [画像: Stars]
インストール ・ クイックスタート ・ 全ツール ・ MCPサーバー ・ Claude Code連携 ・ トークンコスト ・ ベンチマーク ・ コントリビューティング
[画像: aict デモ: 従来のls出力とaictの構造化された出力]
問題点
AIエージェントはls、grep、catを実行しても、人間が読めるプレーンテキストしか得られません。その後、トークンを消費して列の位置を解析したり、フィールド幅を推測したり、一貫性のないフォーマットを処理したりします。これは脆弱で無駄が多いです。
-rw-r--r-- 1 user staff 2048 Apr 6 10:00 main.go ← サイズの列はどれ?
-rw-r--r-- 1 user staff 1024 Apr 6 10:00 utils.go ← 言語は何?
drwxr-xr-x 5 user staff 160 Apr 6 10:00 internal ← これはディレクトリ?
解決策
aictは34のUnixツールを再実装し、エージェントが直接読み取れる構造化された出力を提供します。解析は不要です。
$ aict ls src/
<ls timestamp="1746123456" total_entries="3">
<file name="main.go" path="src/main.go" absolute="/project/src/main.go"
size_bytes="2048" size_human="2.0K" language="go" mime="text/x-go"
binary="false" executable="false" modified="1746120000" modified_ago_s="3456"/>
<file name="utils.go" path="src/utils.go" absolute="/project/src/utils.go"
size_bytes="1024" size_human="1.0K" language="go" mime="text/x-go"
binary="false" executable="false" modified="1746120000" modified_ago_s="3456"/>
<directory name="internal" path="src/internal" modified="1746120000"/>
</ls>
すべてのフィールドにラベルが付いています。パスは常に絶対パスです。タイムスタンプはUnixエポック秒です。言語とMIMEタイプは自動検出されます。解析は一切不要です。
インストール
Homebrew (macOS)
brew tap synseqack/aict
brew install aict
これにより、aictとbashおよびzsh用のシェル補完がインストールされます。MCPサーバーも組み込まれています: aict mcp。
Go Install
go install github.com/synseqack/aict@latest
ソースからビルド
git clone https://github.com/synseqack/aict
cd aict
go build -o aict .
インストール確認:
aict --helpで利用可能なすべてのツールが表示されるはずです。
クイックスタート
# デフォルト: XML出力 (AIエージェントに最適)
aict ls src/
aict grep "func" . -r
aict cat main.go
aict diff old.go new.go
# JSON出力
aict ls src/ --json
# プレーンテキスト (元のUnixツールと同じ)
aict ls src/ --plain
# XMLはデフォルトです。これはシェルエイリアスで --json/--plain を上書きする場合にのみ必要です
export AICT_XML=1
ツール
6つのカテゴリにわたる34のツール。すべてのツールは --xml (デフォルト)、--json、--plain をサポートします。コンパクトモード (デフォルト) はトークンを節約するために短い属性名を使用します。冗長な出力には --no-compact を、マッピングを確認するには --dict を使用してください。
| カテゴリ | ツール |
|---|---|
| ファイル検査 | cat head tail file stat wc |
| 検索と比較 | ls find grep diff |
| パスユーティリティ | realpath basename dirname pwd |
| テキスト処理 | sort uniq cut tr sed awk |
| データとアーカイブ | jq tar |
| システムと環境 | env system ps df du checksums md5sum sha1sum sha256sum |
追加: git (status, diff, log, ls-files, blame) ・ completions (bash/zsh/fish) ・ doctor (自己診断)
出力フォーマット
すべてのツールは同じ規約に従います:
| フィールド | コンパクト (デフォルト) | 冗長 (--no-compact) |
|---|---|---|
| パス | p, a | path, absolute |
| タイムスタンプ | t (エポック整数) + ma (_ago_s) | timestamp + modified_ago_s |
| サイズ | s (バイト) + sh (size_human) | size_bytes + size_human |
| ブール値 | 1 / 0 | ` |