maka-agentを読む: ログを中心に組み立てたエージェントランタイム

maka-agentの四つの実行面

READMEはMakaを、ホストファーストではなくローカルファーストのエージェントワークスペースとして紹介している。セッション、設定、実行記録はデフォルトでマシン上に残り、モデル接続はユーザーが選択する。クラウドAPI、ローカルモデル、互換ゲートウェイのいずれかだ。同じランタイムは4つの面で公開される。デスクトップアプリはElectronとReactで構成され、ストリーミングセッション、ツールタイムライン、分岐、検索、リカバリを提供する。ターミナルTUIとCLIはデスクトップとワークスペースとモデル接続を共有し、`maka`と`maka run`をサポートする。ヘッドレス実行は、`maka eval`を通じて永続タスク、回復可能なTaskRun、実験、評価を対象とする。READMEは、デスクトップビルドが現在macOS Apple Silicon（arm64）のみをサポートし、Intel Mac、Windows、Linuxパッケージはまだサポートされていないことを明示している。

READMEのCLIエントリポイントをテスト用ディレクトリで実行し、イベントログと画面やAPIの射影が一致するか比較する。

maka-agentでは、章の主題に対応する入力、出力、エラー、保存状態を別々に記録します。READMEに記載がない既定値は推測せず、対象版の実行結果と公式資料の差分として扱います。確認対象は章ごとに変え、同じ結論を別の表現で繰り返さないようにします。maka-agentのmaka-agentの四つの実行面については、成功したという印象だけを残さず、使用した版、入力の形、実行時間、返された内容、失敗時のメッセージを同じ記録にまとめます。これにより、READMEの機能説明と手元の環境で再現した挙動を分けて読めます。

イベントログから作られる射影

中心的な設計主張は、ログがランタイムであるということだ。モデルメッセージ、ツール呼び出し、ツール結果、終了事実はRuntime Event Logに入り、セッション、UI、モデルコンテキスト、リカバリはそのログの射影である。READMEはコンテキストと履歴の間に線を引く。ツール結果のプルーニングとLLM圧縮は、記録された証拠を使い捨てのコンテキストとして扱うことなく、次の推論が見るものを変更する。タスクは単一のターンを超えて存続できる。HeadlessはTaskRun、Task Event Log、予算、継続を使用して、中断可能で検査可能な永続作業を前進させる。自己チェックは証拠と1回の制限付き修復機会を生成するかもしれないが、READMEは「チェックした」がシステム事実にはならないと述べている。

タスクを途中で停止して再開し、永続化された状態、再実行されたイベント、重複しない処理を記録する。

maka-agentでは、章の主題に対応する入力、出力、エラー、保存状態を別々に記録します。READMEに記載がない既定値は推測せず、対象版の実行結果と公式資料の差分として扱います。確認対象は章ごとに変え、同じ結論を別の表現で繰り返さないようにします。maka-agentのイベントログから作られる射影については、成功したという印象だけを残さず、使用した版、入力の形、実行時間、返された内容、失敗時のメッセージを同じ記録にまとめます。これにより、READMEの機能説明と手元の環境で再現した挙動を分けて読めます。

現在のエージェント機能

ランタイムは複数のモデル接続、ストリーミング出力、思考、使用量計上、プロバイダーエラー正規化をサポートする。ローカルツールにはRead、Write、Edit、Bash、Glob、Grepが含まれ、ツールスキーマ検証、動的可用性、権限ポリシー、ウォッチドッグ、中止、エラー分類が組み合わされる。ランタイムはRuntime Event Log、AgentRun台帳、起動時リカバリ、ターン証拠、アクティブなツール結果プルーニング、履歴圧縮も維持する。デスクトップワークスペースは、ターンからセッションを作成、アーカイブ、検索、名前変更、再試行、再生成、分岐でき、アーティファクトリストとプレビュー、ワークスペース指示、モデル設定、権限設定を提供する。ローカルメモリ、ウェブ検索、ボットエントリポイントは存在するが、統合は個別に設定され、すべての実験的エントリがデフォルトで利用可能なわけではない。

ストレージ移行とバックアップの手順をコピーしたデータで試し、復旧後のログ順序と設定ファイルを確認する。

maka-agentでは、章の主題に対応する入力、出力、エラー、保存状態を別々に記録します。READMEに記載がない既定値は推測せず、対象版の実行結果と公式資料の差分として扱います。確認対象は章ごとに変え、同じ結論を別の表現で繰り返さないようにします。maka-agentの現在のエージェント機能については、成功したという印象だけを残さず、使用した版、入力の形、実行時間、返された内容、失敗時のメッセージを同じ記録にまとめます。これにより、READMEの機能説明と手元の環境で再現した挙動を分けて読めます。

永続タスクと自己進化の線引き

永続的な作業のために、Makaは追記専用のTask Event LogとTaskRun射影を使用し、予算、権限一時停止、継続、結果エクスポート、失敗タスクの再試行を備える。重いタスクの自己チェックは計画優先、ソース保護、試行制限付きであり、AHEターゲットプロトコルと証拠エクスポートがある。READMEは、完全な自動自己反復は現在の公開ビルドの一部ではなく、外部または実験的なワークフローのままであると述べている。READMEのこのセクションには、パフォーマンスデータや他のエージェントフレームワークとの比較はない。リポジトリメタデータは1,195スター、135フォーク、124のオープンイシューを示すが、アクティブなコントリビューター数やリリース頻度については何も述べていない。

maka-agentでは、章の主題に対応する入力、出力、エラー、保存状態を別々に記録します。READMEに記載がない既定値は推測せず、対象版の実行結果と公式資料の差分として扱います。確認対象は章ごとに変え、同じ結論を別の表現で繰り返さないようにします。maka-agentの永続タスクと自己進化の線引きについては、成功したという印象だけを残さず、使用した版、入力の形、実行時間、返された内容、失敗時のメッセージを同じ記録にまとめます。これにより、READMEの機能説明と手元の環境で再現した挙動を分けて読めます。

CLIとローカルデータ境界

デスクトップアプリはGitHub Releasesから`Maka-<version>-mac-arm64.dmg`としてApple Silicon Mac向けに配布され、ランタイムのGrepツールを有効にするには`brew install ripgrep`でripgrepを個別にインストールする必要がある。開発にはNode.js 22.19以上（CIはNode.js 24を使用）、npm（現在のpackageManagerはnpm 11）、Git、ripgrepが必要だ。ソースからデスクトップを起動するには、READMEは`git clone https://github.com/Maka-Agent/maka-agent.git`、`cd maka-agent`、`npm ci`、`npm run dev`を示している。`npm run dev`はHMR付きのデスクトップ開発環境を起動し、`npm run dev:full`はElectronを起動する前にすべてのワークスペースをビルドする。依存関係が`ELECTRON_SKIP_BINARY_DOWNLOAD=1`でインストールされた場合は、先に`node node_modules/electron/install.js`を実行する。初回実行では共有モデルアカウントはバンドルされず、ユーザーは設定→モデルでAPI、ローカルモデル、またはサポートされているアカウント接続を追加する。

タスクを途中で停止して再開し、永続化された状態、再実行されたイベント、重複しない処理を記録する。

maka-agentでは、章の主題に対応する入力、出力、エラー、保存状態を別々に記録します。READMEに記載がない既定値は推測せず、対象版の実行結果と公式資料の差分として扱います。確認対象は章ごとに変え、同じ結論を別の表現で繰り返さないようにします。maka-agentのCLIとローカルデータ境界については、成功したという印象だけを残さず、使用した版、入力の形、実行時間、返された内容、失敗時のメッセージを同じ記録にまとめます。これにより、READMEの機能説明と手元の環境で再現した挙動を分けて読めます。

移行、バックアップ、開発検証

ワークスペースをビルドした後、TUIは`npm --workspace maka-agent exec -- maka`で起動し、単一のターンは`maka run`で実行する。TUIは`/graph on`、`/graph off`、`/graph <task>`を受け付ける。非対話型の`--graph`実行は、永続グラフが完了するのを待ってから最終的なスーパーバイザー出力を印刷する。グラフ実装オペレーターは分離されたGit worktreeを使用するため、ソースプロジェクトはクリーンなGit worktreeである必要がある。CLIはデスクトップが書き込むのと同じモデル接続とワークスペース設定を読み取る。ローカルデータはデフォルトで`<Electron userData>/workspaces/default/`に保存され、`runtime.sqlite`はセッション、メッセージ、実行台帳、ワークフロー、使用量、アーティファクトメタデータ、自動化、ヘッドレスTaskRunの唯一の運用権限である。アーティファクトのペイロードバイトは`artifacts/`の通常ファイルのままである。APIキー、ボットトークン、プロキシパスワードなどのランタイム資格情報は現在、ローカルの平文`credentials.json`にあり、OSアカウント境界の背後にあり、POSIXディレクトリモード0700とファイルモード0600が強制される。レンダラーは平文の資格情報を受け取らず、ファイル書き込み、シェル、危険なツール呼び出しは権限エンジンを通過する。

maka-agentでは、章の主題に対応する入力、出力、エラー、保存状態を別々に記録します。READMEに記載がない既定値は推測せず、対象版の実行結果と公式資料の差分として扱います。確認対象は章ごとに変え、同じ結論を別の表現で繰り返さないようにします。maka-agentの移行、バックアップ、開発検証については、成功したという印象だけを残さず、使用した版、入力の形、実行時間、返された内容、失敗時のメッセージを同じ記録にまとめます。これにより、READMEの機能説明と手元の環境で再現した挙動を分けて読めます。

編集部の結論

イベントログを根拠にエージェントのタスク状態を追跡し、復旧や移行を検証したい開発者に適します。READMEのCLIと保存先を固定して停止、再開、移行、バックアップを順に試し、イベントと射影の差分を確認してから、自己進化の説明を運用上の自動変更と混同しないよう範囲を決めてください。

公式情報源

1. Official README
2. Project repository
3. Release notes