Agent CLI とは？

Agent CLI はローカルファーストの AI Agent ランタイムワークスペースです。開発の意図を、復元可能なセッション、観測可能なラン、監査可能なトレース、プロジェクトメモリに変換します。すべてのデータはエンジニアリングワークスペース内に保存されます。

単なるターミナルで包んだチャットボットではありません。Alius は自らの進化に参加できるソフトウェアのために構築されています：目標を理解し、計画を生成し、制御されたランタイム境界を通じて実行し、証拠を記録し、結果をレビューし、学びを次の反復に持ち込むことができます。

主要機能

  • プラン駆動ワークスペース — 単なるチャットインターフェースではなく、目標の理解、計画の生成、制御された実行、結果のレビューを中心に構築された Agent ランタイム
  • デュアルモード実行 — 複雑なマルチステップタスク用のプランモード、素早い単一ターン対話用のバイパスモード
  • プロジェクトレベルの設定 — モデルプール、ロールアイデンティティ、セキュリティポリシーをプロジェクト単位で管理
  • 階層型メモリ — ワーキングメモリ、エピソードメモリ、セマンティックメモリの3層体系で、セッション間でプロジェクト知識を蓄積
  • セキュリティ境界 — Shell Gate がすべてのシェル・ファイル操作に対してリスク分析と承認制御を実施
  • ローカルファースト — すべてのデータは .alius/ ディレクトリに保存、データのアップロードは不要

動作要件

  • macOS 12+ または Linux (x86_64 / ARM64)
  • Windows 10+ (PowerShell)
  • Node.js 18+（npm インストール用）
  • Rust 1.75+（ソースからのビルドのみ）

クイックインストール

curl -fsSL https://alius.tech/install | sh

パッケージマネージャー経由のインストール：

# npm
npm install -g @alius-tech/alius

# Homebrew
brew tap AliusTech/tap
brew install alius

インストールの確認：

alius --version

プロジェクトの初期化

プロジェクトディレクトリで実行：

cd your-project
alius init

alius init はインタラクティブな初期化ウィザードを起動し、以下を案内します：

  1. 言語選択 — ワークスペースのインターフェース言語を選択
  2. モデルプール設定 — 対応プロバイダーからモデルをインポート（BigModel、Xiaomi MiMo、DeepSeek など）
  3. モデル割り当て — Plan、Execute、Review の3ロールにモデルを指定
  4. Soul 選択 — Agent のロールアイデンティティを選択

初期化が完了すると、プロジェクトディレクトリに .alius/ 構造が生成されます：

your-project/
├── .alius/
│   ├── config/         # プロジェクト設定（providers.toml, model.toml, soul.toml など）
│   ├── memory/         # プロジェクトメモリストレージ
│   └── workspace/      # ワークスペースドキュメント
├── src/
└── ...

初期化ウィザードは再開可能です。途中で中断した場合、再度 alius init を実行すると前回の続きから再開できます。

ワークスペースに入る

インタラクティブワークスペースを起動：

alius

Ratatui ベースの TUI ワークスペースインターフェースが表示されます：

  • トップバー — バージョン、Soul、モード、ネットワークステータス
  • セッションエリア — ワークフロー会話ブロック（Request, Understanding, Plan Proposal, Execution, Prompt, Output, Error）
  • プランパネル — プランノード、ステータス、受入基準、証拠（プランモード承認後のみ表示）
  • インタラクションエリア — テキスト入力、オプション選択、承認コントロール
  • ステータスバー — 現在のワークスペース、Git ステータス、ランタイムステータス

2つの実行モード

TUI ワークスペースでは、Shift+Tab で2つのモードを切り替えられます：

プランモード（推奨デフォルト）

複雑なマルチステップタスク向け。ワークフロー：

  1. 目標を記述する
  2. モデルが不明な要件について積極的に質問（選択肢または穴埋め形式）
  3. モデルが実行可能なプランリストを生成
  4. プランを承認する
  5. 承認されたプランノードが順次実行される
  6. 実行完了後、プランパネルを閉じて確認

プランモードは最大20回の反復をサポートし、ツールの呼び出し、シェルコマンドの実行、収束の確認が可能です。

バイパスモード

素早い単一ターン対話向け — 質問、確認、軽量分析。バイパスモードは入力を単一ターン実行に直接送信します。モデルは1回のツール呼び出しを要求する場合がありますが、マルチターンの反復ループには入りません。

ワンショット実行

インタラクティブワークスペースが不要な場合、単一プロンプトを直接実行できます：

alius run -p "このモジュールに対して構造化コードレビューを実行"

これはチャットモードで単一リクエストを実行し、結果を標準出力にストリームするワンショットコマンドです。

次のステップ

  • インストールガイド — 詳細なインストールオプション、プラットフォームサポート、グローバルパラメータ
  • クイックスタートガイド — ステップバイステップのチュートリアル
  • コア概念 — ワークスペース、セッション、モードの詳細
  • コマンド — CLI コマンドと TUI スラッシュコマンドリファレンス
  • 設定 — プロバイダー、モデルプール、セキュリティポリシーの設定