Help: AI apps and coding time

Connect Hourcrumb to AI apps to ask about your time or log it in plain words, and let the time you spend in coding tools turn into suggested blocks by itself. Both need Hourcrumb Plus and a Hourcrumb account.

Your computer

Ask an AI app about your time

Add Hourcrumb to the app once. The first time it uses Hourcrumb, it opens Hourcrumb in your browser: sign in and choose Allow. There's no key to copy.

Claude

In the Claude app on your computer, or at claude.ai: Settings → Connectors → Add custom connector. Name it Hourcrumb, paste this address, then choose Connect. It then works in the Claude app on your phone too.

https://api.hourcrumb.com/mcp

Claude Code

Only for Claude Code in a terminal (it needs the claude command). Run this, then type /mcp in Claude Code and choose hourcrumb to sign in.

claude mcp add --transport http hourcrumb https://api.hourcrumb.com/mcp

Codex

Run these in a terminal. The second one opens Hourcrumb to sign in.

codex mcp add hourcrumb --url https://api.hourcrumb.com/mcp
codex mcp login hourcrumb

Cursor

On the computer with Cursor, use the button, or add this address in Cursor Settings → MCP. Sign in when Cursor asks.

Add to Cursor

https://api.hourcrumb.com/mcp

Antigravity

In the Agent panel, open … → MCP Servers → Manage MCP Servers → View raw config, add these lines and save. Sign in when it asks.

{
  "mcpServers": {
    "hourcrumb": {
      "serverUrl": "https://api.hourcrumb.com/mcp"
    }
  }
}

Then try: "How much did I work on each project this week?" or "Log 2 hours on Writing this morning."

Log coding time by itself

While you work with an AI coding tool, Hourcrumb notes which folder you're in, at most once a minute, and turns it into suggested blocks named like "Claude Code · my-app". You confirm them like any other suggestion.

Claude Code · Codex

1. Install Node.js

Download the LTS installer from https://nodejs.org and open it. If you use Homebrew, you can run this instead:

brew install node

To check, run this in a terminal: it should show v18 or newer.

node -v

2. Open a terminal

Press Cmd+Space, type Terminal and press Return.

3. Run these

npx hourcrumb login
npx hourcrumb setup claude
npx hourcrumb setup codex

The first opens Hourcrumb in your browser: sign in and choose Allow. The others add Hourcrumb to Claude Code and Codex, and keep a backup of each file they change. Skip the line for a tool you don't use.

4. Restart the tool

Quit Claude Code or Codex and open it again: tracking starts with the next session. In the Claude desktop app, open a new Code session.

Antigravity · VS Code · Cursor

Open Extensions, search for Hourcrumb and choose Install. Then open the command palette (Cmd+Shift+P), run "Hourcrumb: Sign in" and choose Allow in your browser. The status bar shows Hourcrumb while it's logging.

Check it works

Work for a minute, then open Today in Hourcrumb: a suggested block named after the tool and the folder shows up after the next sync. To see whether the terminal tool is signed in and set up, run:

npx hourcrumb status

If it stops

If you disconnected the app in Settings → AI apps, or didn't use it for 90 days, sign in again: npx hourcrumb login (in the editors, "Hourcrumb: Sign in"). Hooks only run in sessions opened after setup.

If npx stops with an npm error such as ENOENT or EPERM, npm's cache is damaged. Run this, then try again:

npm cache verify

Remove it

Run this, and Disconnect the app in Settings → AI apps. Setup left a copy of each file it changed next to it (ending in .hourcrumb-backup), if you want the old one back.

npx hourcrumb logout

What's sent

Only the tool's name and the folder's name (not the path), at most once a minute. Prompts, code, file names and replies stay on your computer. More in the privacy policy.