Timestripe CLI

The official command-line client for the Timestripe.

---

Install

Homebrew (macOS, Linux)

brew install timestripe/tap/timestripe-cli

Upgrade later with:

brew upgrade timestripe-cli

From source

Requires Go 1.26+.

go install github.com/timestripe/timestripe-cli/cmd/timestripe@latest

Or clone and build:

git clone https://github.com/timestripe/timestripe-cli
cd timestripe-cli
make build   # → ./bin/timestripe

Pre-built binaries

Download for macOS or Linux (amd64 / arm64) from the Releases page.

Quick start

timestripe auth login                       # opens your browser
timestripe spaces list
timestripe boards list --space <space-id>
timestripe goals create --bucket <bucket-id> --title "Ship the thing"

Every command has --help with full flag and subcommand documentation:

timestripe --help
timestripe goals create --help

Authentication

OAuth authentication with your browser:

timestripe auth login

Skip the browser by using a personal api key (manage keys in Settings):

timestripe auth login --token <your-api-key>

Or supply a token per-invocation via env, bypassing stored credentials entirely:

export TIMESTRIPE_TOKEN=<your-api-key> timestripe ...

Related commands:

• timestripe auth whoami — show the authenticated user
• timestripe auth status — verify the stored token still works
• timestripe auth logout — remove stored credentials

AI agents

timestripe works with any AI agent that can run shell commands — --json output is structured, exit codes are stable, and a ready-made skill ships with the repo.

• Claude Code: drop skills/timestripe/ into ~/.claude/skills/ (global) or <your-project>/.claude/skills/ (per-project). Claude loads it automatically when you mention goals, tasks, todos, spaces, or Timestripe.
• Other agents: point the agent at skills/timestripe/SKILL.md. It documents the command surface, JSON envelope, server-side filters, and common recipes.

Commands

Command	Purpose
auth	Log in, log out, inspect the active session
spaces	Manage spaces
boards	Manage boards
buckets	Manage buckets
goals	Manage goals
memberships	Manage workspace memberships
users	Look up users
config	Show resolved configuration
version	Print version, commit, and build date

Most resource commands expose list, get, create, update, and delete subcommands. Run --help on any command for details.

Output formats

Pick a format with one of these mutually-exclusive flags:

Flag	Output
--json	JSON
--yaml	YAML
--table	Pretty table (default on a TTY)
--markdown	Markdown table
--csv	CSV

When stdout isn't a TTY, the default switches to JSON, so piping is safe:

timestripe goals list --json | jq '.[] | select(.completed == false) | .title'

Pagination

List commands accept:

Flag	Effect
--limit <n>	Max items returned across all pages
--offset <n>	Starting offset into the result set
--all	Fetch every page; ignores --limit

Configuration

Config and credentials live in $XDG_CONFIG_HOME/timestripe/ (default ~/.config/timestripe/).

Environment overrides:

Variable	Effect
TIMESTRIPE_TOKEN	Bearer token used for all requests; overrides stored credentials.
TIMESTRIPE_BACKEND	Timestripe site root (default https://timestripe.com). Useful for staging or self-hosted environments.
XDG_CONFIG_HOME	Override the config directory base.

Inspect what the CLI sees:

timestripe config show

License

MIT — see LICENSE.

Links

• Timestripe
• Issues
• Releases