Time Momentumを、使っているツールにつなぐ。

コマンドラインtm、Claude Code・Codex・Cursor用のエージェントコレクター、AIエージェントがそのまま実行できるセットアップガイド、そしてそのすべてを支えるREST API。

  • macOS、Linux、Windows
  • Node.js 22.14以降

セットアップはAIエージェントに任せる。

Claude Code、Codex、Cursorに1文を貼り付けるだけです。エージェントがガイドを読み、Node.jsを確認してtmをインストールし、その後、あなた自身のターミナルで接続するよう求めます。APIキーはそこで入力するので、会話に現れることはありません。

Set up the Time Momentum agent collector on this computer. Read and follow this guide: https://www.time-momentum.com/agents/collector.md

エージェント向けのMarkdownガイド:エージェントコレクターとコマンドラインtm。アプリのセットアップ画面にも同じプロンプトが表示されます。

AIセッションを記録する。

エージェントコレクターは、Claude Code、Codex、Cursorのすべてのセッションの時間、モデル、使用量をフックを通じて記録します。Freeプランでも使えます。

  1. tmをインストールする

    Windows(PowerShell):irm https://app.time-momentum.com/install-cli.ps1 | iex。その後、新しいターミナルを開きます。

    curl -fsSL https://app.time-momentum.com/install-cli.sh | sh
  2. APIキーを作成する

    アプリの「Datenquellen › Agent-Kollektor」で作成します。キーは一度だけ表示されます。

  3. 接続する

    キーを非表示の入力で求め、続いて記録するツールと、サブスクリプションの利用上限を通知するかどうかを尋ねます。キーが拒否された場合は何も変更されません。

    tm collect init
  4. 確認する

    tm collect status

コンピューターの外に出るのは計測値だけです:時間、モデル、使用量、フォルダー、コミット。ソースコードやファイル名は送信されません。会話からは最大でもセッションのタイトルだけで、これもオフにできます。

コマンドラインで作業する。

読み取り権限のキーで、プロジェクトと作業時間のエントリーを扱えます。それ以外はすべて読み取り・書き込み権限が必要で、これはProプランに含まれます。

  1. tmをインストールする

    コレクターですでにインストール済みなら不要です。

    curl -fsSL https://app.time-momentum.com/install-cli.sh | sh
  2. ログインする

    アプリの「Datenquellen › CLI」でキーを作成します。tmがキーを非表示の入力で求めます。

    tm auth login
  3. ログインと権限を確認する

    tm whoami
  4. Claude Code:スキルをインストールする

    tm skill --install
  5. Claude Code:ステータスライン

    現在のセッションのプロジェクト、工数、予算をClaude Codeの下部に表示します。

    tm statusline install

インストールせずに使うこともできます(エージェントのサンドボックスなど):npx -y @time-momentum/cli@latest whoami

Claude Codeプラグイン。

同じスキルに加えて、コマンド/time-momentum:setupが使えるようになります。どちらのコマンドもClaude Codeの中で実行してください。

  1. マーケットプレイスを追加する

    /plugin marketplace add https://time-momentum.com/claude/marketplace.json
  2. プラグインをインストールする

    /plugin install time-momentum@time-momentum

コマンドグループ。

APIの各操作に、対応するコマンドがちょうど1つあります。tm schema <group> --json でフラグ、型、例を一覧できます。

グループ対象
tm timers作業時間の開始、一時停止、停止、記録
tm customers, tm projects, tm orders顧客、予算付きのプロジェクト、案件とその請求方式
tm invoices, tm payments請求書の作成・発行・電子請求書としてのエクスポート、入金の記録と配分
tm statements請求書の添付資料または単独の作業報告書
tm ai-sessions, tm progress稼働時間と使用量を含むエージェントセッション、プロジェクトの進捗
tm revenue, tm dashboard, tm export採算、主要指標、CSVまたはExcelでの生データ
tm collectエージェントコレクター:ツールの接続、同期、サブスクリプションの利用上限
tm api任意のエンドポイントを直接呼び出し。認証はほかのコマンドと同じ

REST API。

tmは https://app.time-momentum.com/api/v1 のREST APIのクライアントです。合計、税、請求書番号などのビジネスロジックはサーバー側にあるため、スクリプトやエージェントもWebアプリと同じ結果を得られます。

APIキー(tmk_…)は、読み取り系のルート、タイマー、コレクターの取り込みでそのままBearerトークンとして使えます。書き込み権限のあるキーは、POST /api/v1/auth/token で1時間有効なトークンに交換します。tmがこれを代わりに行い、自動で更新します。

キーはWebアプリでのみ作成でき、そこでいつでも無効にできます。エージェントからのアクセスによるキーの作成やアカウントの削除は、サーバーが拒否します。

すべての操作のパラメーター、リクエスト・レスポンスのスキーマ:OpenAPI仕様(OpenAPI 3.1、説明文はドイツ語)。

エージェントとスクリプト向け。

  • llms.txt:このWebサイトのページとセットアップガイドを1つのファイルに
  • agents/collector.mdとagents/cli.md:AIエージェント向けのセットアップガイド
  • tm --json:すべてのコマンドグループ、規約、終了コードの簡潔な概要
  • openapi.yaml:OpenAPI 3.1形式のREST API
  • tm schema --json:フラグ、型、エンドポイントを含む完全なコマンドカタログ
  • tm skill:インストール済みのバージョンに合ったエージェント向けの利用ガイド

今日、ツールをつなぐ。

  • Proを30日間
  • クレジットカード不要
  • その後はFreeで継続

よくある質問

Proプランは必要ですか?

エージェントコレクター、タイマー、プロジェクト一覧はFreeプランで使えます。コマンドラインとエージェントからの書き込み、請求書、その他の機能はProプランに含まれ、新しいアカウントはすべて30日間お試しできます。

エージェントがAPIキーを尋ねないのはなぜですか?

キーが会話に残らないようにするためです。エージェントはtmをインストールした後、あなた自身のターミナルで tm collect init または tm auth login を実行するよう求めます。キーはそこで非表示の入力として入力します。

MCPサーバーはありますか?

いいえ。エージェントはすでにシェルで作業しており、tmはコマンドカタログのうち必要な部分だけを読み込みます。詳しくはガイドAIエージェントにとってのMCPとCLIの違いをご覧ください。