DevTrack

DevTrack の機能

• 通常の Git コマンドを妨げたり置き換えたりすることなく、コミットを監視します。
• v3.3.0 の開発系列では、作業時間やタスクごとの所要時間を記録せずに、完了した作業を報告します。
• feature/AUTH-42-refresh-token のようなチケット名付きブランチを作業項目に対応付けます。
• 完了した作業に基づいて、確認可能なチケット更新と終業時レポートを作成します。
• クライアント側の信頼できる情報源をローカルの SQLite に保持し、ローカル AI にはデフォルトで Ollama を使用します。
• 10 個の読み取り専用 MCP ツールを通じて、現在の作業と DevTrack Sage のナレッジを互換性のあるアシスタントと共有します。

DevTrack が生成しただけで何かが投稿されることはありません。PM の更新、ステータス遷移、納品物は、承認されるまで保留中のアクションキューに置かれます。匿名テレメトリーもオプトイン方式で、デフォルトでは無効です。

はじめに

DevTrack は Windows、macOS、Linux に対応しています。Git が必要です。コアとなる Go クライアント、SQLite ストレージ、Git の監視、キュー、MCP 機能には、Python も AI モデルも必要ありません。管理対象の AI 機能を使うには uv、PostgreSQL、LLM プロバイダーが必要です。デフォルトでは Ollama を使用します。

1. インストール

ガイド付きのダウンロードページを使うか、最新の安定版リリースを直接インストールしてください。

Linux または macOS

curl -fsSL https://devtrack.cloud/install.sh | sh

Windows PowerShell

irm https://devtrack.cloud/install.ps1 | iex

手動で利用できるバイナリとチェックサムは、GitHub Releasesから入手できます。

安定版 v3.2.0 では、以前の時間追跡動作が維持されています。修正と削除は dev の 860b91b にあり、v3.3.0 向けに準備されています。開発中のビルドには dev-<commit> が使用されます。dev へのプッシュによって、インストール済みのバイナリがアップグレードされたり、新しい安定版リリースが公開されたりすることはありません。開発版リリースノートと適格性確認計画をご覧ください。

devtrack version

2. リポジトリを設定する

DevTrack に監視させる Git リポジトリからセットアップを実行してください。

cd /path/to/your/repository
devtrack setup
devtrack start
devtrack status
devtrack doctor

セットアップウィザードで、動作モード、リポジトリ、LLM、ID、任意の PM 連携を設定します。ローカルのみでの利用を試す場合は、PM 連携に none を選択してください。管理対象モードで任意の Python サービスを使うには PostgreSQL が必要です。そのサービスとモデルの準備中も、Go ネイティブ機能は引き続き利用できます。

3. ワークフローを試す

チケット名を付けたブランチを使い、通常どおりコミットします。

git switch -c feature/AUTH-42-refresh-token
git commit -m "fix auth redirect"

devtrack logs
devtrack queue
devtrack eod

queue を使うと、承認する前にステージングされたアクションを確認できます。最初の実行時の手順全体については、クイックスタートをご覧ください。

開発ラインでは、capture によってローカルブランチの各先端にある未確認のコミットが列挙されるため、処理中の素早いコミットやブランチの切り替えも含まれます。デーモンは起動したままにしてください。既存の履歴は起動時にシードされますが、停止中に作成されたコミットの補完は保証されません。

devtrack work start AUTH-42 はフォールバックのチケットコンテキストを選択し、work stop はそれをクリアし、work status はその内容を表示します。これらのコマンドはタイマーを開始または停止しません。devtrack work report は、設定済みのサーバーを通じてコミットベースのEODレポートを生成します。

インシデント、ストーリー、バグ、タスクはすべて、作業項目の参照情報によってマッピングされます。たとえば、Jiraのインシデント hotfix/OPS-123-restore-login、Azure DevOpsのストーリー feature/ADO-456-add-export、またはGitHubのissue fix/GH-42-handle-timeout です。項目の種類はPMシステムが提供し、ブランチの種類では決まりません。優先順位は、正規のブランチ、明示的なコミット参照、選択されたチケットコンテキストの順です。ルールを確認するには devtrack ticket convention と devtrack ticket check <branch> を実行します。確認されたマッピングを修正するには devtrack ticket link <commit-hash> <ticket-ref> を実行します。設定、競合、例については、作業項目とチケットのマッピングをご覧ください。

devtrack eod status と devtrack eod show は、ローカルとサーバーの履歴を通じて最新のレポートを読み取ります。devtrack queue list --all は、両方のストアにある最近のアクションを表示します。サーバーのアクションには server:123 のようなIDが使われます。queue approve、queue reject、または queue edit に渡す際は、このID全体を指定してください。数値のみのIDはローカルのアクションを指します。サーバーが利用できない場合は、その旨が明示的に報告されます。

エージェントのメモリとDevTrack Sage

読み取り専用のDevTrack MCP サーバーを現在のプロジェクトに追加します。

devtrack mcp setup
devtrack mcp test
devtrack mcp status

セットアップ後、MCP対応アシスタントを再読み込みしてください。アシスタントは、現在のチケットコンテキスト、コミット、保留中のアクション、EODコンテキスト、音声情報、公開済みのSageナレッジを読み取れるようになります。MCPではアクションの承認やDevTrackデータの変更はできません。

DevTrack Sageは、対応するコーディングハーネスで役立つコマンドの実行状況を記録し、繰り返し行われる作業を検索可能なローカルMarkdownナレッジに変換します。

devtrack sage status
devtrack sage search "docker compose"
devtrack sage topics

詳しくは、MCPとエージェントメモリおよびDevTrack Sageをご覧ください。

次に進む

目的	ガイド
DevTrackをインストールまたはアップグレードする	ダウンロード
初回実行時のワークフローを完了する	クイックスタート
デプロイ方法の選択肢を理解する	インストール
リポジトリ、インテグレーション、またはモデルを設定する	設定
コマンドを探す	CLIリファレンス
AIアシスタントを接続する	MCPとエージェントメモリ
ローカルのコマンドナレッジを使う	DevTrack Sage
インストールまたは実行時の問題を解決する	トラブルシューティング
プライバシーとデータフローを確認する	プライバシー
自動記録とレポートを検証する	基本的なワークフローのテスト
インシデント、ストーリー、バグ、タスクをマッピングする	作業項目とチケットのマッピング
v3.3.0の開発範囲を確認する	開発リリースノート

貢献者やメンテナーは、リポジトリのドキュメントマップとアーキテクチャから確認を始められます。

プライバシー

デフォルトの Go、SQLite、Ollama の構成では、データはローカルに保持されます。外部の PM システム、配信チャネル、クラウド LLM にデータが送信されるのは、該当する操作向けに設定した場合のみです。テレメトリーは、devtrack telemetry on で明示的に有効にするまでオフのままです。外部サービスを有効にする前に、プライバシーガイド全文をお読みください。

ライセンス

DevTrack は DevTrack Community License を採用しています。個人利用および最大 10 ユーザーのチームは無料です。それを超える規模のチームおよびホステッド利用には、エンタープライズライセンスが必要です。