Installation
Repo: github.com/derekified/struggletime.
Requirements
- A release archive or a Rust toolchain to build from source
- Git
- Node 22+ only if you rebuild docs (
make docs)
Releases & prebuilt binaries
Download from GitHub Releases
(built on each v* tag). Each archive is one struggletime binary that
bundles:
- tray supervisor
- CLI (
status,start,apikey, …) - background tracker (
daemon) - local HTTP server (
serve)
macOS Universal (Apple Silicon + Intel)
macOS Intel (x86_64)
Windows (x64)
A .zip of the same binary is also published. See
Releases.
Checksums
Every release includes SHA256SUMS.txt. Prefer verifying before first run.
Build from source
Sign in and API key
- Continue with Hack Club Slack.
- Claim a public handle if asked.
- Settings → Profile → create a StruggleTime API key (
st_...). - Paste it:
Link a project
Shell hooks (exec categories only, never argv):
Debug
Debug logs print allowlisted labels only (editor, event_type, counts) —
never paths, prompts, or argv.
Config paths
| What | Where |
|---|---|
| Settings | ~/.config/struggletime/settings.json (Windows: %APPDATA%\struggletime\) |
| Runtime logs | ~/.aitime/ |
| Local history log | .aitime-ledger.json in the watched repo |