Skip to content

Set up Ember

About two minutes. One install connects every editor and AI agent you use. Nothing to download by hand, and your code never leaves your computer.

Before you start

  1. Sign in with GitHub or Google. Your account is created the first time.
  2. Open Settings, click Create API key and copy it. It starts with ember_. One key works for every tool.
  3. For the terminal setup you need Node.js 18 or newer. Check with node -v; if it's missing, install it from nodejs.org.

Quick setup

Recommended

This connects everything it finds on your computer at once: VS Code, Cursor and Windsurf (the extension), and Claude Code, Codex and Cursor's agent (the hooks).

  1. Install the Ember CLI with your package manager:
    npm install -g embertime

    Using bun or pnpm? bun add -g embertime or pnpm add -g embertime.

  2. Connect everything, replacing YOUR_KEY with your key:
    embertime setup --key YOUR_KEY
  3. That's it. Write some code, and within about 30 seconds your time shows up on your dashboard.

Rather not install anything globally? Run it once with npx embertime setup --key YOUR_KEY.

VS Code

Editor
  1. Open the Extensions view (⇧⌘X on Mac, Ctrl+Shift+X on Windows/Linux), search embertime and install Ember: Coding Time Tracker. Or from a terminal:
    code --install-extension ember-dev.embertime
  2. Open the command palette (⇧⌘P / Ctrl+Shift+P), run Ember: Set API Key and paste your key.
  3. A flame with today's time appears in the status bar. Click it to open your dashboard.

Cursor

Editor
  1. In Cursor, open Extensions (⇧⌘X), search embertime and install it. Cursor gets it from Open VSX. Or:
    cursor --install-extension ember-dev.embertime
  2. Run Ember: Set API Key from the command palette and paste your key.
  3. Want Cursor's AI agent counted too? See Cursor Agent below.

Windsurf

Editor
  1. Open Extensions, search embertime and install it. Or:
    windsurf --install-extension ember-dev.embertime
  2. Run Ember: Set API Key from the command palette and paste your key.

Claude Code

AI agent
  1. Run the quick setup. It adds Ember's hooks to ~/.claude/settings.json and backs up the file first:
    embertime setup --key YOUR_KEY
  2. Start a new Claude Code session. Prompts, edits and replies now count as AI time for the project you're in.

Codex

AI agent
  1. Run the quick setup. It adds Ember's hooks to ~/.codex/hooks.json:
    embertime setup --key YOUR_KEY
  2. Open Codex and type /hooks, then trust the Ember entries. Codex only runs hooks you've trusted, so this step is required once.

Cursor Agent

AI agent
  1. Run the quick setup. It adds Ember's hooks to ~/.cursor/hooks.json, next to any hooks you already have:
    embertime setup --key YOUR_KEY
  2. Restart Cursor. Work the agent does (prompts and file edits) now counts as AI time, separate from your own typing.

Check it works

  1. See what's connected, today's time and anything waiting to sync:
    embertime status
  2. On your dashboard, Your tools shows each editor and agent with when it was last seen.

Troubleshooting

“command not found: embertime”
Your global npm folder isn't on your PATH. Use npx embertime setup --key YOUR_KEY instead; it does the same thing.
“The server rejected that key”
The key was regenerated or mistyped. Create a new one in Settings and run setup again.
Codex isn't showing up
Open Codex, run /hooks and trust the Ember entries.
I installed a new editor or agent later
Run embertime setup again. It's safe to repeat and only adds what's missing.
Remove Ember
embertime uninstall removes the hooks and extension. Add --purge to delete local data too.

Ember records when and in which project you code, never your code or prompts. Privacy policy.

Ready? Start with your API key.

Sign in to get your key