AIエージェントのためのCRM：エージェントにできること
必要なことを伝えれば、エージェントがtmのコマンドに変換します。
- 昨日、リニューアル案件に2時間を記録して
tm timers add --project-id <project-id> --started-at "yesterday 09:00" --duration 2:00 - 顧客Muster GmbHを作成して
tm customers create --name "Muster GmbH" --payment-terms-days 14 - Muster GmbHの9月分の請求書を作って
tm invoices build --customer-id <client-id> --month 2026-09 - 問題ないので発行して
tm invoices finalize <invoice-id> --yes - 1件の振込で両方の請求書が支払われた
tm payments split --paid-on today --allocation <a>=3451.00 --allocation <b>=2998.80 - 9月の作業報告書
tm statements create --customer-id <client-id> --period-from 2026-09-01 --period-to 2026-09-30 - まだ支払われていないのは？
tm payments outstanding - 今年、顧客ごとの採算はどうだった？
tm revenue --from 2026-01-01 --to 2026-12-31
エージェントによる操作はProプランに含まれます。
エージェントに許されていること
| 操作 | ルール |
|---|---|
| 読み取り、記録、作成、編集 | 直接実行できます：作業時間、顧客、案件、プロジェクト、プロジェクト経費、請求書の下書き、入金、作業報告書、レポート。 |
| 発行、取消、削除 | 明示的な --yes がある場合のみ。ない場合、tmは何も送信せずに停止します。利用ガイドは、あなたが求めたときにだけ実行するようエージェントに指示しています。 |
| 請求済みの時間の変更 | 拒否されます。発行済みの請求書や確定した作業報告書に含まれる時間はロックされます。 |
| 不完全な電子請求書の発行 | 拒否されます。請求書は下書きのまま残り、tmが不足している項目と修正箇所をすべて示します。 |
| キーの作成、アカウントの削除 | エージェントによるアクセスではサーバー側でブロックされます。メール確認なしのパスワード変更も同様です。新しいキーはWebアプリでのみ作成できます。 |
セキュリティモデル
エージェントは、Webアプリで作成し、いつでも無効にできるAPIキーで作業します。
- tmは書き込み用キーを1時間有効なトークンに交換し、自動で更新します。交換にはレート制限があります。
- キーはローカルの設定ファイル（ファイルモード600）または環境変数にのみ保存されます。出力、ログ、エラーに表示されることはなく、
--verboseや--dry-runでも同様です。 - 読み取り用キーで使えるのは、一部の読み取りルートとタイマーだけです。
- キーの無効化は取り消せず、即座に有効になります。
--dry-runは、送信せずに正確なリクエストを表示します。既存のファイルが黙って上書きされることはありません。
エージェントのための設計
エージェントは手順とコマンド一覧を自分で取得し、どの応答も次に何をすべきかを伝えます。
- どんなコマンドグループがある？
tm --json - 請求書にはどんなフラグがある？
tm schema invoices --json - インストール済みバージョンの利用ガイド
tm skill - 送信前にリクエストを見せて
tm invoices finalize <invoice-id> --dry-run
エージェントによる操作はProプランに含まれます。
| 特徴 | 意味すること |
|---|---|
| 網羅的 | すべてのAPI操作に、ちょうど1つのコマンドがあります。APIを変更するたびにテストで確認しています。 |
| 予測可能 | --json を付けると、標準出力にはJSONドキュメントがちょうど1つだけ出力されます。エラーもJSONで返り、終了コードで、呼び出しを直すべきか、あなたに確認すべきか、待つべきか、再試行すべきかがわかります。 |
| どこでも動く | macOS、Linux、Windowsで動作し、エージェントのサンドボックスなどではインストールせずにnpx経由でも使えます。 |
| すべてが1か所に | 請求書、案件、未入金は、あなたが作成してもエージェントが作成しても、Time Momentumにまとまります。 |
エージェント用にtmを設定する
Node.js 22.14以降と、Webアプリで作成した権限「読み取りと書き込み」のAPIキーが必要です。
tmを恒久的にインストール
npx -y @time-momentum/cli installAPIキーでログイン
tm auth loginログインと権限を確認
tm whoamiClaude Code：スキルをインストール
tm skill --installClaude Code：ステータスライン
現在のセッションのプロジェクト、工数、予算をClaude Codeの下部に表示します。
tm statusline installAIセッションを記録
Claude Code、Codex、Cursorを、トークンと稼働時間付きで。Freeプランでも使えます。
tm collect init
エージェントのサンドボックスなどでは、インストールせずに使うこともできます：npx -y @time-momentum/cli@latest whoami
Proプランに含まれます
tmによるエージェントのアクセスはProプランに含まれます。新しいアカウントはすべて、Proを30日間、クレジットカードなしで試せます。
Proプランがなくても、APIキーでタイマーとプロジェクト一覧は使えます。
よくある質問
なぜMCPサーバーではなくCLIなのですか？
エージェントはすでにシェルで作業しています。tmは、すべてのツール定義を最初に読み込むのではなく、必要な部分のコマンド一覧だけを読み込みます。Claude Code、Codex、Cursor、そしてコマンドを実行できるほかのあらゆるエージェントで同じように動き、すべてのコマンドを自分で実行して、エージェントが何をしたのかを正確に確認できます。Time MomentumのMCPサーバーはありません。
どのエージェントがtmを使えますか？
シェルコマンドを実行できるすべてのエージェントです。Claude Codeには tm skill --install で、完全なガイドを参照する短いスキルが入ります。Codex、Cursorなどは tm skill でガイドを読み、常にインストール済みのバージョンに合った内容になります。
エージェントが間違えたらどうなりますか？
下書きは変更も削除もできます。発行済みの請求書は取消によって訂正し、そこに含まれる時間はロックされます。--dry-run を使えば、エージェントは送信前に正確なリクエストを見せられます。