로그인

Time Momentum을 사용하는 도구와 연결합니다.

커맨드라인 tm, Claude Code·Codex·Cursor용 에이전트 수집기, AI 에이전트가 따라 할 수 있는 설정 가이드, 그리고 이 모두를 받치는 REST API입니다.

계정 만들기 에이전트에게 설정 맡기기
  • macOS, Linux, Windows
  • Node.js 22.14 이상

설정은 AI 에이전트에게 맡기세요.

Claude Code, Codex, Cursor에 문장 하나만 붙여 넣으세요. 에이전트가 가이드를 읽고 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 작업에 명령이 정확히 하나씩 있습니다. 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 클라이언트입니다. 합계, 세금, 청구서 번호 같은 비즈니스 로직은 서버에 있으므로 스크립트와 에이전트도 웹 앱과 같은 결과를 얻습니다.

API 키(tmk_…)는 조회 경로, 타이머, 수집기 수집 엔드포인트에서 바로 bearer 토큰으로 쓸 수 있습니다. 쓰기 권한 키는 POST /api/v1/auth/token으로 1시간 동안 유효한 토큰과 교환합니다. tm이 이 작업을 대신하고 자동으로 갱신합니다.

키는 웹 앱에서만 만들 수 있고 언제든 폐기할 수 있습니다. 서버는 에이전트 접근을 통한 키 생성과 계정 삭제를 거부합니다.

모든 작업의 파라미터, 요청·응답 스키마: OpenAPI 명세 (OpenAPI 3.1, 설명은 독일어).

에이전트와 스크립트를 위해.

  • llms.txt: 이 웹사이트의 페이지와 설정 가이드를 한 파일에
  • agents/collector.md, agents/cli.md: AI 에이전트용 설정 가이드
  • tm --json: 모든 명령 그룹, 규칙, 종료 코드의 간단한 개요
  • openapi.yaml: OpenAPI 3.1로 된 REST API
  • tm schema --json: 플래그, 타입, 엔드포인트를 포함한 전체 명령 목록
  • tm skill: 설치된 버전에 맞는 에이전트용 사용 가이드

오늘 바로 도구를 연결하세요.

계정 만들기 AI 에이전트용
  • 30일 Pro 체험
  • 신용카드 불필요
  • 이후 Free로 계속 사용

자주 묻는 질문

Pro가 필요한가요?

에이전트 수집기, 타이머, 프로젝트 목록은 Free에서 동작합니다. 커맨드라인과 에이전트의 쓰기 권한, 청구서 및 기타 기능은 Pro에 포함되며, 모든 신규 계정은 30일 동안 Pro를 체험할 수 있습니다.

에이전트가 API 키를 묻지 않는 이유는 무엇인가요?

키가 대화에 남지 않도록 하기 위해서입니다. 에이전트는 tm을 설치한 뒤 직접 연 터미널에서 tm collect init 또는 tm auth login을 실행하라고 안내하며, 키는 거기서 숨김 입력으로 입력합니다.

MCP 서버가 있나요?

아니요. 에이전트는 이미 셸에서 작업하며, tm은 필요한 명령 목록만 불러옵니다. 자세한 내용은 가이드 AI 에이전트에게 MCP와 CLI 중 무엇이 맞을까를 참고하세요.