{"id":50271918,"url":"https://github.com/shelltime/coding-extension-jetbrains","last_synced_at":"2026-05-27T18:05:09.612Z","repository":{"id":347300215,"uuid":"1128440273","full_name":"shelltime/coding-extension-jetbrains","owner":"shelltime","description":"it's a coding extension for jetbrains. track the coding activity","archived":false,"fork":false,"pushed_at":"2026-01-09T15:41:28.000Z","size":117,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-27T21:37:38.021Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/shelltime.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-05T16:32:29.000Z","updated_at":"2026-01-09T15:40:42.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/shelltime/coding-extension-jetbrains","commit_stats":null,"previous_names":["shelltime/coding-extension-jetbrains"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/shelltime/coding-extension-jetbrains","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shelltime%2Fcoding-extension-jetbrains","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shelltime%2Fcoding-extension-jetbrains/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shelltime%2Fcoding-extension-jetbrains/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shelltime%2Fcoding-extension-jetbrains/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/shelltime","download_url":"https://codeload.github.com/shelltime/coding-extension-jetbrains/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/shelltime%2Fcoding-extension-jetbrains/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33577696,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-27T02:00:06.184Z","response_time":53,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-27T18:05:09.549Z","updated_at":"2026-05-27T18:05:09.601Z","avatar_url":"https://github.com/shelltime.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ShellTime for JetBrains\n\n[![CI](https://github.com/shelltime/coding-extension-jetbrains/actions/workflows/release.yml/badge.svg)](https://github.com/shelltime/coding-extension-jetbrains/actions/workflows/release.yml)\n[![JetBrains Plugin](https://img.shields.io/badge/JetBrains-Install%20Plugin-blue?logo=jetbrains)](https://plugins.jetbrains.com/plugin/29657-shelltime)\n[![codecov](https://codecov.io/gh/shelltime/coding-extension-jetbrains/graph/badge.svg?token=d7WgY0yRtw)](https://codecov.io/gh/shelltime/coding-extension-jetbrains)\n\n\u003ciframe width=\"245px\" height=\"48px\" src=\"https://plugins.jetbrains.com/embeddable/install/29657\"\u003e\u003c/iframe\u003e\n\nTrack your coding time and productivity across projects with ShellTime. Automatic language detection, project analytics, and detailed activity insights.\n\n\u003c!-- Plugin description --\u003e\n## Features\n\n- **Automatic Time Tracking** - Tracks your coding activity in the background without interrupting your workflow\n- **Language Detection** - Automatically detects and categorizes time by programming language\n- **Project Analytics** - View time spent per project and workspace\n\u003c!-- Plugin description end --\u003e\n\n## Prerequisites\n\nThis plugin requires the ShellTime CLI and daemon to be running. Follow the steps below to set up.\n\n### Step 1: Install the ShellTime CLI\n\nRun this command in your terminal:\n\n```bash\ncurl -sSL https://shelltime.xyz/i | bash\n```\n\nAfter installation, reload your shell configuration:\n\n```bash\n# For zsh\nsource ~/.zshrc\n\n# For fish\nsource ~/.config/fish/config.fish\n\n# For bash\nsource ~/.bashrc\n```\n\n### Step 2: Initialize and Authenticate\n\nRun the initialization command:\n\n```bash\nshelltime init\n```\n\nThis command will:\n- Open your browser for authentication\n- Install shell hooks for your shell (zsh/fish/bash)\n- Start the background daemon service\n\n### Step 3: Enable Code Tracking\n\nEnsure your daemon config at `~/.shelltime/config.yaml` has code tracking enabled:\n\n```yaml\ncodeTracking:\n  enabled: true\n```\n\nOr if using `~/.shelltime/config.toml`:\n\n```toml\n[codeTracking]\nenabled = true\n```\n\n### Verify Installation\n\nCheck that the daemon is running:\n\n```bash\nshelltime daemon status\n```\n\n## Installation\n\n### From JetBrains Marketplace\n\n1. Open your JetBrains IDE (IntelliJ IDEA, WebStorm, PyCharm, etc.)\n2. Go to **Settings/Preferences** → **Plugins** → **Marketplace**\n3. Search for \"ShellTime\"\n4. Click **Install** and restart your IDE\n\n### Manual Installation\n\n1. Download the latest release from [GitHub Releases](https://github.com/shelltime/coding-extension-jetbrains/releases)\n2. Go to **Settings/Preferences** → **Plugins** → **⚙️** → **Install Plugin from Disk...**\n3. Select the downloaded ZIP file\n4. Restart your IDE\n\n## Plugin Settings\n\nConfigure the plugin at **Settings/Preferences** → **Tools** → **ShellTime**:\n\n* **Enable ShellTime tracking** - Enable/disable tracking (default: enabled)\n* **Enable debug logging** - Log debug information to IDE logs (default: disabled)\n* **Socket path** - Path to the ShellTime daemon socket (default: `/tmp/shelltime.sock`)\n* **Heartbeat flush interval** - Interval in milliseconds between heartbeat flushes (default: `120000`)\n\n## Commands\n\nAccess commands from **Tools** → **ShellTime**:\n\n* **Show Status** - Display daemon connection status and version info\n* **Flush Heartbeats** - Manually flush pending heartbeats to the daemon\n\n## How It Works\n\nThe plugin monitors your IDE activity and sends heartbeats to a local daemon:\n\n1. **Event Monitoring** - Tracks file opens, edits, saves, and cursor movements\n2. **Debouncing** - Batches events to reduce overhead (max 1 heartbeat per file per 30 seconds)\n3. **Periodic Flush** - Sends collected heartbeats to the daemon every 2 minutes\n4. **Offline Support** - Queues heartbeats when daemon is unavailable\n\n## Status Bar\n\nThe plugin shows its status in the IDE status bar:\n\n- **ShellTime** - Connected and tracking\n- **ShellTime (offline)** - Daemon not running (heartbeats queued)\n\nClick the status bar item to view daemon status.\n\n## Supported IDEs\n\nThis plugin supports all JetBrains IDEs based on IntelliJ Platform 2024.1+:\n\n- IntelliJ IDEA (Community \u0026 Ultimate)\n- WebStorm\n- PyCharm (Community \u0026 Professional)\n- GoLand\n- PhpStorm\n- RubyMine\n- CLion\n- Rider\n- DataGrip\n- Android Studio\n\n## Privacy\n\nThe plugin communicates only with the local ShellTime daemon via Unix socket. The daemon syncs your coding activity to the ShellTime server for analytics and cross-device access.\n\n## Development\n\n### Building from Source\n\n```bash\n# Clone the repository\ngit clone https://github.com/shelltime/coding-extension-jetbrains.git\ncd coding-extension-jetbrains\n\n# Build the plugin\n./gradlew buildPlugin\n\n# Run tests\n./gradlew test\n\n# Run IDE with plugin for testing\n./gradlew runIde\n```\n\n### Project Structure\n\n```\nsrc/main/kotlin/xyz/shelltime/jetbrains/\n├── config/          # Configuration loading and settings\n├── heartbeat/       # Heartbeat data models and collection\n├── socket/          # Unix socket communication\n├── listeners/       # IDE event listeners\n├── services/        # Application and project services\n├── actions/         # Menu actions\n├── ui/              # Status bar widget\n└── utils/           # Utility functions\n```\n\n## License\n\nSee [LICENSE](LICENSE) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshelltime%2Fcoding-extension-jetbrains","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fshelltime%2Fcoding-extension-jetbrains","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fshelltime%2Fcoding-extension-jetbrains/lists"}