URL INTEGRATION

A small URL scheme for starting and finishing runs.

Token Goblin accepts `tokengoblin://` URLs for `start`, `finish`, and `show` actions. This is a lightweight integration for scripts and tools that already know the task details; it does not read terminal output or your project files.

Download free for MacSee Token Goblin

AT A GLANCE

  • Scheme: tokengoblin://
  • Commands: start, finish, show
  • Runners: Codex, Claude, Xcode, Terminal, Custom
  • Estimate range: 1–120 minutes
  • No project-file or output inspection

Seven-day full access. One-time lifetime unlock. Apple shows the current localized price in the Mac App Store.

Start a run

Use `tokengoblin://start` with optional `title`, `agent`, and `expected` query parameters. Supported runner labels are Codex, Claude, Xcode, Terminal, and Custom. The estimate is clamped to 1–120 minutes, and a missing title or estimate receives a safe default.

Finish with observed details

Use `tokengoblin://finish` with `success`, `files`, `tests`, and `permission`. Boolean values accept common forms such as `true`, `1`, `yes`, and `pass`; counts are clamped to non-negative values. The app uses only the fields the URL supplies.

Safe boundaries

Unknown schemes and commands are rejected. A start is rejected while another run is active, and integrations are locked after the seven-day trial until the lifetime unlock is purchased. `tokengoblin://show` remains available to bring the app forward.

URL examples

open 'tokengoblin://start?title=Run%20tests&agent=Claude&expected=8'
open 'tokengoblin://finish?success=true&files=12&tests=0&permission=false'
open 'tokengoblin://show'

Common questions

Can I track any task manually?

Yes. Token Goblin supports manual tracking for any task, plus CLI automation for terminal commands. Choose a runner label such as Codex, Claude, Xcode, Terminal, or Custom.

Does Token Goblin read my code, prompts, or terminal output?

No. Token Goblin does not read prompts, source code, repository contents, terminal output, or file paths. The CLI sends only the task details and result metrics you explicitly provide.

Can I restore a previous lifetime purchase?

Yes. Open Settings, choose License, and select Restore Purchase. StoreKit checks Apple for a previous lifetime entitlement; the website does not process payment details.