このガイドでは、インストールから最初のプラン駆動タスクの完了までを案内します。

ステップ 1：Alius をインストール

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

インストールの確認：

alius --version

ステップ 2：プロジェクトを初期化

プロジェクトディレクトリに移動し、初期化ウィザードを実行：

cd your-project
alius init

初期化ウィザードは以下のステップを案内します：

  1. 言語選択 — ワークスペースのインターフェース言語を選択（例：English、中文、日本語）
  2. モデルプール設定 — プロバイダーを選択（BigModel GLM、Xiaomi MiMo、DeepSeek など）、API Key を入力し、リモートからモデルをインポート
  3. モデル割り当て — Plan Model、Execute Model、Review Model の3ロールにモデルを選択
  4. Soul 選択 — Agent のロールアイデンティティを選択（例：senior-engineer、code-reviewer など）

初期化が完了すると、.alius/ ディレクトリには以下が含まれます：

.alius/
├── config/             # プロジェクト設定
│   ├── config.toml     # メイン設定
│   ├── providers.toml  # プロバイダー、モデルプール、API Key
│   ├── model.toml      # Plan/Execute/Review モデル割り当て
│   ├── soul.toml       # Agent アイデンティティ
│   ├── tools.toml      # ツール設定
│   ├── permissions.toml # セキュリティ権限
│   └── mcp.json        # MCP サーバー
├── memory/             # プロジェクトメモリ
└── workspace/          # ワークスペースドキュメント

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

ステップ 3：ワークスペースに入る

alius

TUI ワークスペースのウェルカム画面が表示され、バージョン番号、現在の Soul、モデル割り当て、モード情報が表示されます。

Enter を押してワークスペースに入ります。

ステップ 4：バイパスモード — クイッククエリ

ワークスペースはデフォルトでバイパスモードで起動します。バイパスモードは素早い単一ターン対話に適しています：

> このプロジェクトの認証モジュールを説明して

バイパスモードの動作：

  • 入力を単一ターン実行に直接送信
  • モデルは1回のツール呼び出しを要求する場合がある
  • マルチターン反復ループには入らない
  • Q&A、説明、軽量分析に適している

ステップ 5：プランモード — 複雑なタスク

Shift+Tab を押してプランモードに切り替え、マルチステップ実行が必要なタスクに対応：

> データベース接続プールをリファクタリングして非同期をサポート

プランモードの完全なワークフロー：

  1. 目標理解 — 目標が不明確な場合、モデルが積極的に質問
    • 質問はオプション形式で表示（単一選択、複数選択、または自由入力）
    • 選択または入力により、タイピングを最小限に抑える
  2. プラン生成 — 目標を十分に理解した後、モデルが実行可能なプランリストを生成
  3. 承認 — プランリストがセッションエリアに表示され、インタラクションエリアで承認または拒否を求める
  4. 実行 — 承認されたプランノードが順次実行
    • ツール呼び出しは Shell Gate の承認を経る
    • セッションエリアにリアルタイムの実行進捗が表示
  5. 完了 — すべてのノードの実行が完了したら、プランの完了を確認し、プランパネルを閉じる

ステップ 6：ワークスペース内設定

ワークスペース内でいつでも設定を調整でき、退出する必要はありません。

/config — 設定センター

/config を入力して埋め込み設定センターを開く。3つのタブがあります：

タブ内容
モデルPlan Model / Execute Model / Review Model の割り当て
言語インターフェース言語の選択
SoulAgent ロールアイデンティティの選択

操作：

  • Tab / Shift+Tab 設定タブの切り替え
  • Up / Down オプションの移動
  • Space マルチセレクトの切り替え
  • Enter 選択の確認
  • Esc 終了（すべての変更は即時反映、保存ボタン不要）

/model — モデルプールマネージャー

/model を入力してローカルモデルプールを管理：

  • 表示 インポート済みのモデルリスト
  • 追加 リモートプロバイダーからモデルを取得（プロバイダー選択 → API モード → Base URL と API Key を入力 → リモート取得 → マルチセレクトでインポート）
  • 削除 インポート済みのモデルを削除（/config で使用中のモデルは削除不可、先に変更が必要）

/model のすべての操作は即時反映され、.alius/config/providers.toml に書き込まれます。

/init — 再初期化

/init を入力して初期化ウィザードを再実行。注意：既存の設定がクリアされ、最初からやり直しになります。

ステップ 7：メモリを保存

タスク完了後、重要な発見をプロジェクトメモリに保存：

> /memory save 非同期接続プールには tokio ランタイムが必要

メモリはセッション間で永続化されるため、次回 Agent が蓄積された知識を活用できます。

ステップ 8：次回の再開

セッションは自動的にワークスペースに保存されます。次回このプロジェクトに取り組むとき：

alius

ワークスペースで以前のセッションを復元し、前回の続きから再開できます。

よく使うショートカット

ショートカット機能
Shift+Tabプラン / バイパスモードの切り替え
Ctrl+Enter入力を送信
Esc入力をクリアまたは現在の操作をキャンセル
Ctrl+Oすべての会話ブロックを展開/折りたたみ
Ctrl+C / Ctrl+Dワークスペースを終了

設定センター内では、Tab / Shift+Tab は設定タブの切り替えに使用され、実行モードの切り替えには使用されません。

次のステップ