ShellTime CLI

Track and analyze your DevOps workflow. shelltime.xyz

Install

curl -sSL https://shelltime.xyz/i | bash

Setup

shelltime init              # Authenticate
shelltime hooks install     # Enable automatic tracking
shelltime daemon install    # Optional: background sync for <8ms latency

Commands

Command	Description
shelltime sync	Sync pending commands to server
shelltime rg "pattern"	Search synced commands (alias: grep)
shelltime q "prompt"	AI-powered command suggestions
shelltime doctor	Diagnose installation issues
shelltime web	Open dashboard in browser
shelltime gc	Clean old tracking data
shelltime ls	List pending commands

Configuration

Config file: ~/.shelltime/config.yaml

token: "your-token"
flushCount: 10           # Commands before sync
gcTime: 14               # Days to retain data
dataMasking: true        # Mask sensitive data
encrypted: false         # E2E encryption (requires daemon)

# Exclude patterns (regex)
exclude:
  - ".*password.*"
  - "^export .*"

# AI permissions
ai:
  agent:
    view: false          # Read-only commands
    edit: false          # File modifications
    delete: false        # Destructive commands

Local overrides: ~/.shelltime/config.local.yaml

Full Configuration Guide - Detailed documentation for all options

Why Daemon Mode?

Mode	Latency	Network Blocking
Direct	~100ms+	Yes
Daemon	<8ms	No

The daemon handles network sync in the background with automatic retry and buffering.

Claude Code Statusline Integration

Display real-time cost and context usage in Claude Code's status bar.

Setup

Add to your Claude Code settings (~/.claude/settings.json):

{
  "statusLine": {
    "type": "command",
    "command": "shelltime cc statusline"
  }
}

The status line will display:

🌿 main* | 🤖 Opus | 💰 $0.12 | 📊 $3.45 | 🚦 5h:23% 7d:12% | ⏱️ 5m30s | 📈 45%

Section	Description
🌿 Git Branch	Current branch name (* if dirty)
🤖 Model	Current model name
💰 Session	Current session cost (clickable link to session detail)
📊 Daily	Today's total cost (clickable link to coding agent page)
🚦 Quota	Anthropic API quota utilization (macOS only, clickable link to usage settings)
⏱️ Time	AI agent session duration (clickable link to user profile)
📈 Context	Context window usage %

For full details, see Claude Code Statusline Guide.

Security

• Data Masking: Sensitive info automatically redacted
• E2E Encryption: Hybrid RSA/AES-GCM encryption (v0.1.12+)
• Exclusion Patterns: Regex-based command filtering

Links

• Documentation
• Dashboard
• Issues

License

Copyright (c) 2026 ShellTime Team. All rights reserved.