# ShellTime - Command Line Analytics Platform

ShellTime (https://shelltime.xyz) is a developer productivity platform that tracks, analyzes, and optimizes command-line usage for zsh and fish shells.

## What is ShellTime?

ShellTime automatically tracks every command executed in your terminal and provides comprehensive analytics to help developers understand and improve their command-line productivity.

## Key Features

- **Command Tracking**: Automatic tracking of all shell commands in zsh and fish
- **Claude Code Usage Analytics**: Optional tracking of Claude Code usage with token counts, costs, and session insights
- **Privacy Protection**: Built-in sensitive data masking to protect private information
- **Analytics Dashboard**: Weekly, monthly, and yearly shell activity reports with detailed insights
- **Data Control**: Users can download and manage their own command history data
- **Sharing**: Generate badges and share basic usage statistics
- **Multi-language Support**: Available in English, Chinese, Korean, and Japanese

## How to Use ShellTime

1. **Installation**: Run the installation script:
   `curl -sSL https://shelltime.xyz/i | bash`

2. **Authentication**: Sign in with GitHub at https://shelltime.xyz

3. **Start Tracking**: Commands are automatically tracked once installed

4. **View Analytics**: Access your dashboard at https://shelltime.xyz/users/[username]

## Advanced Features

- **Webhooks**: Integration capabilities for personal data workflows
- **Shell Aliases**: Custom alias management and tracking
- **Command Details**: Deep dive into individual command execution data
- **Timeline View**: Chronological view of command history

## MCP Integration (AI Assistants)

ShellTime provides a remote MCP (Model Context Protocol) server so AI
assistants like Claude and ChatGPT can query your data in natural language:

- **Endpoint**: https://api.shelltime.xyz/api/v3/mcp (streamable HTTP)
- **Authentication**: OAuth 2.1 with PKCE and dynamic client registration; the user approves read-only access on shelltime.xyz
- **Tools**: search_commands, top_commands, commands_stats, ai_usage_summary, ai_usage_daily, ai_model_breakdown, ai_sessions_list, ccusage_projects, coding_activity_summary, coding_activity_stats, coding_activity_breakdown, user_profile, list_hosts
- **Setup guide**: https://shelltime.xyz/mcp

## Privacy & Security

- Sensitive data is automatically masked
- Users maintain full control over their data
- GitHub-based authentication
- Data export capabilities
- Claude Code usage tracking is optional and analyzed anonymously
- Data is never sold or shared with any third party

ShellTime is free to use and focuses on helping developers optimize their command-line workflows through data-driven insights.