shelltime.xyzRankingPlans
Sign In
© 2026 shelltime.xyz. All rights reserved.
Version: 3e9c9e0
TermsPrivacyContactAbout

Install ShellTime

Get started with ShellTime in just a few simple steps

After installation, you can start tracking your shell commands automatically

1

Install the CLI

Run this command in your terminal to install the ShellTime CLI:

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

Initialize ShellTime

Login to your account, setup shell hooks, and start the daemon:

shelltime init
Authenticate with your account
Install shell hooks (zsh/fish/bash)
Start background daemon
3

Configure (Optional)

Customize your ShellTime configuration at ~/.shelltime/config.yaml

Configuration Options

PRIVACY & SECURITY
Data Masking

Automatically mask sensitive data (API keys, passwords, etc.) before syncing

E2E Encryption

Enable end-to-end encryption (requires daemon mode)

SYNC SETTINGS
Flush Count

Number of commands to buffer before syncing (minimum: 3)

GC Time (days)

Days to keep local data after syncing to server

AI FEATURES
Show AI Tips

Show helpful tips when using AI features

AI Agent Auto-Execution
Auto-execute View Commands

Automatically execute read-only commands (ls, cat, grep)

Auto-execute Edit Commands

Automatically execute file modification commands

Auto-execute Delete Commands

Automatically execute delete commands (DANGEROUS)

AI CODING TOOLS
OpenTelemetry Integration
Enable AI CLI Tracking

Enable OpenTelemetry tracking for AI coding tools (Claude Code, Codex, etc.)

gRPC Port

OpenTelemetry gRPC server port (default: 54027)

Debug Mode

Write debug files for troubleshooting

CODE TRACKING
Enable Code Tracking

Track coding activity heartbeats

LOG MANAGEMENT
Auto Log Cleanup

Automatically clean up log files when they exceed threshold

Threshold (MB)

Clean files larger than this size in MB

YAML Preview

Read-only

After editing your config:

1

Install AI coding environment:

We recommend running both commands to ensure compatibility with all AI coding tools.

For Claude Code:

For Codex:

2

Install editor plugins for code tracking:

VS Code Extension

VS Code Extension

Install from Visual Studio Marketplace

Neovim Plugin

Neovim Plugin

Install from GitHub

JetBrains Plugin

JetBrains Plugin

Install from JetBrains Marketplace

3

Reload configuration:

Remember to restart all terminal sessions and coding editors to apply the new settings.