stemplin-cli

Command-line interface and Claude Code skill for the Stemplin time tracking API.

Install

From a clone:

git clone https://github.com/rubynor/stemplin-cli.git
cd stemplin-cli
bash install.sh

One-liner (downloads from GitHub):

curl -sSL https://raw.githubusercontent.com/rubynor/stemplin-cli/main/install.sh | bash

The installer places:

• bin/stemplin → ~/bin/stemplin
• skill/stemplin-api.md → ~/.claude/skills/stemplin-api.md
• completions/stemplin.bash → ~/.local/share/bash-completion/completions/stemplin

Make sure ~/bin is in your PATH:

export PATH="$HOME/bin:$PATH"

Configuration

Set these environment variables (or put them in ~/.stemplinrc):

export STEMPLIN_URL="https://stemplin.com"    # or http://localhost:3000
export STEMPLIN_API_TOKEN="your-token-here"
export STEMPLIN_ORG_ID=""                       # optional

Get your API token from the Stemplin web UI (Profile → API Token) or with stemplin me after initial setup.

Usage

stemplin [--raw] [--org ID] <command> [action] [flags]

Commands

Command	Actions	Description
me	—	Show your profile and token
orgs	list, show ID	Organizations
clients	list, show, create, update, delete	Clients
projects	list, show, create, update, delete	Projects
tasks	list, show	Tasks
time	list, show, create, update, delete, timer	Time entries
users	list, show, me	Users
reports	show	Time reports
token	regenerate	API token management
help	[command]	Show help

Examples

# See your profile
stemplin me

# List today's time entries (default)
stemplin time list

# Log 2 hours on assigned task 42
stemplin time create --task 42 --minutes 120 --notes "Feature work"

# Start a timer
stemplin time create --task 42 --minutes 0
stemplin time timer 123    # toggle on

# Weekly report
stemplin reports show --from 2025-01-13 --to 2025-01-19

# List projects
stemplin projects list

# Create a client
stemplin clients create --name "Acme Corp"

# Raw JSON output
stemplin --raw time list

Time Entry Flags

stemplin time list [--date YYYY-MM-DD] [--from DATE --to DATE] [--project ID] [--per-page N]
stemplin time create --task ID [--minutes N] [--date YYYY-MM-DD] [--notes TEXT]
stemplin time update ID [--task ID] [--minutes N] [--date YYYY-MM-DD] [--notes TEXT]

Report Flags

stemplin reports show [--from DATE] [--to DATE] [--clients IDS] [--projects IDS] [--users IDS] [--tasks IDS]

IDs are comma-separated (e.g. --projects 1,2,3).

Claude Code Skill

The installer places stemplin-api.md in ~/.claude/skills/. This enables Claude Code to use the Stemplin API from any terminal conversation:

"Log 2 hours on the website project for today" "What did I work on this week?" "Show me a report for January"

Claude will use the stemplin CLI or raw curl commands to interact with the API.

Dependencies

• curl
• jq
• column (usually pre-installed)

Tab Completion

The installer sets up bash completion automatically. To load manually:

source completions/stemplin.bash

License

MIT