CLI Installation

The Hype Doc CLI (hype) lets you log wins and list achievements from your terminal.

Install

npm
npx (no install)

npm install -g @hypedoc/cli

npx @hypedoc/cli log "My first win" --space Work

Requires Node.js 20+.

Authenticate

Browser login (recommended)
Terminal window
```
hype auth login
```
Opens your browser for OAuth authentication. The token is saved automatically.
Or set a token directly (for CI/scripts)
Terminal window
```
hype auth token hdoc_xxxxxxxxxxxxxxxxxxxx
```
Verify
Terminal window
```
hype auth status
```

Quick examples

# Log a win
hype log "Shipped the new API endpoint" --space Work --tags impact,backend

# List recent wins
hype list --last 7d

# List wins in a space
hype list --space Work --limit 10

# See your spaces
hype spaces

# Create a space
hype spaces create Leadership --emoji 👑

# See your tags
hype tags

# Rename a tag
hype tags rename backend infrastructure

Commands

Command	Description
`hype log`	Log a new win
`hype list`	List your wins
`hype spaces`	List, create, and delete spaces
`hype tags`	List, rename, and delete tags
`hype auth`	Manage authentication

Configuration

The CLI stores its config at ~/.hypedoc/config.json. See Configuration for environment variables and advanced setup.