{"id":35687296,"url":"https://github.com/yurinachos/claude-scope","last_synced_at":"2026-02-01T19:00:56.223Z","repository":{"id":331749505,"uuid":"1128323861","full_name":"YuriNachos/claude-scope","owner":"YuriNachos","description":"Beautiful, customizable statusline for Claude Code CLI. Multiple widgets, themes, AI-friendly configuration. Zero runtime dependencies.","archived":false,"fork":false,"pushed_at":"2026-01-25T13:34:53.000Z","size":2082,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-26T06:22:20.636Z","etag":null,"topics":["claude-code","claude-code-plugin","cli","statusline","terminal","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/YuriNachos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","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-05T13:20:40.000Z","updated_at":"2026-01-25T13:34:56.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/YuriNachos/claude-scope","commit_stats":null,"previous_names":["yurinachos/claude-scope"],"tags_count":79,"template":false,"template_full_name":null,"purl":"pkg:github/YuriNachos/claude-scope","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YuriNachos%2Fclaude-scope","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YuriNachos%2Fclaude-scope/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YuriNachos%2Fclaude-scope/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YuriNachos%2Fclaude-scope/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/YuriNachos","download_url":"https://codeload.github.com/YuriNachos/claude-scope/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/YuriNachos%2Fclaude-scope/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28986340,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-01T18:17:03.387Z","status":"ssl_error","status_checked_at":"2026-02-01T18:16:57.287Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["claude-code","claude-code-plugin","cli","statusline","terminal","typescript"],"created_at":"2026-01-05T22:19:44.369Z","updated_at":"2026-02-01T19:00:56.204Z","avatar_url":"https://github.com/YuriNachos.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n  \u003cimg src=\"https://cdn.jsdelivr.net/gh/devicons/devicon/icons/typescript/typescript-original.svg\" alt=\"TypeScript\" width=\"80\" height=\"80\"/\u003e\n\n  # claude-scope\n\n  ### Beautiful, customizable statusline for Claude Code CLI\n\n  [![npm version](https://badge.fury.io/js/claude-scope.svg)](https://www.npmjs.com/package/claude-scope)\n  [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE.md)\n  [![Node.js Version](https://img.shields.io/node/v/claude-scope.svg)](https://github.com/YuriNachos/claude-scope)\n  [![GitHub Stars](https://img.shields.io/github/stars/YuriNachos/claude-scope?style=social)](https://github.com/YuriNachos/claude-scope)\n  [![codecov](https://codecov.io/gh/YuriNachos/claude-scope/branch/main/graph/badge.svg)](https://codecov.io/gh/YuriNachos/claude-scope)\n\n  **Features** · [Installation](#-quick-start) · [Configuration](#-ai-powered-customization) · [Widgets](#-available-widgets) · [Themes](#-themes)\n\n\u003c/div\u003e\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003ci\u003eReal-time session analytics in your terminal — zero runtime dependencies, 14 widgets, 17 themes\u003c/i\u003e\n\u003c/p\u003e\n\n---\n\n## What is it?\n\n**claude-scope** is a CLI plugin for [Claude Code](https://claude.ai/code) that displays real-time session information directly in your statusline. Track your context usage, session cost, git status, active tools, and more — all with beautiful customizable themes.\n\n- **Zero runtime dependencies** — pure TypeScript, native Node.js only\n- **14 customizable widgets** — model, context, cost, git, docker, and more\n- **17 built-in themes** — from Dracula to Nord to Cyberpunk\n- **12 display styles** — balanced, playful, compact, verbose, technical...\n- **AI-friendly configuration** — just ask Claude to customize it!\n\n---\n\n## Preview\n\nSee how claude-scope looks with different themes:\n\n**Dracula Theme** (default)\n```\nClaude Opus 4.5  |  67% [████████]  |  +127/-42  |  $1.24  |  2h 15m\nmain [+127 -42]  |  v0.8.16  |  💾 45.2k  |  📄 1 📜 2 🔌 3 🪝 2\n⚡ Nuxt (running)  |  🐳 3/5 🟢  |  Edits: 8 | Bash: 3 | Read: 12\n```\n\n**Tokyo Night Theme**\n```\nClaude Opus 4.5  |  67% [████████]  |  +127/-42  |  $1.24  |  2h 15m\nmain [+127 -42]  |  v0.8.16  |  💾 45.2k  |  📄 1 📜 2 🔌 3 🪝 2\n⚡ Nuxt (running)  |  🐳 3/5 🟢  |  Edits: 8 | Bash: 3 | Read: 12\n```\n\n**Nord Theme**\n```\nClaude Opus 4.5  |  67% [████████]  |  +127/-42  |  $1.24  |  2h 15m\nmain [+127 -42]  |  v0.8.16  |  💾 45.2k  |  📄 1 📜 2 🔌 3 🪝 2\n⚡ Nuxt (running)  |  🐳 3/5 🟢  |  Edits: 8 | Bash: 3 | Read: 12\n```\n\n---\n\n## Quick Start\n\nGet up and running in 30 seconds:\n\n```bash\n# 1. Install via npx (no installation required)\nnpx -y claude-scope@latest\n\n# 2. Add to your ~/.claude/settings.json\n{\n  \"statusLine\": {\n    \"type\": \"command\",\n    \"command\": \"npx -y claude-scope@latest\",\n    \"padding\": 0\n  }\n}\n\n# 3. Restart Claude Code — you're done! 🎉\n```\n\nAfter the first run, a default config is automatically created at `~/.claude-scope/config.json` with:\n- **Layout**: `rich` (3 lines)\n- **Style**: `balanced`\n- **Theme**: `dracula`\n\n---\n\n## 🤖 AI-Powered Customization\n\n**claude-scope is built to work with AI!** Simply ask Claude to customize it:\n\n```\n➕ \"Add the docker widget to the third line\"\n🎨 \"Switch theme to nord\"\n😄 \"Make it more playful\"\n🎯 \"Show only model and context\"\n```\n\n**Example dialogue:**\n\n\u003e **User:** Add poker widget and make everything playful\n\u003e\n\u003e **Claude:** Sure! Adding poker widget and changing styles to playful...\n\u003e\n\u003e ✅ Done! Your statusline now shows poker hands with emojis.\n\nClaude will automatically modify `~/.claude-scope/config.json` — changes take effect instantly.\n\n**How it works:**\n- Config contains `$aiDocs` field linking to [AI-CONFIG-GUIDE](AI-CONFIG-GUIDE.md)\n- AI understands all 14 widgets, 12 styles, and 17 themes\n- Just say what you want — no manual editing needed\n\n---\n\n## Available Widgets\n\n| Widget | Description | Balanced | Playful |\n|--------|-------------|----------|---------|\n| **model** | Current Claude model | `Claude Opus 4.5` | `🤖 Opus 4.5` |\n| **context** | Context usage with progress bar | `45% [████████░░░░░░░░░]` | `📊 45% [████████░░░░░░░░░]` |\n| **cost** | Session cost in USD | `$0.42` | `💰 $0.42` |\n| **duration** | Session duration | `1h 15m 30s` | `⌛ 1h 15m` |\n| **lines** | Lines added/removed | `+42/-18` | `➕42 ➖18` |\n| **git** | Git branch and changes | `main [+42 -18]` | `🔀 main ⬆42 ⬇18` |\n| **git-tag** | Latest git tag | `v0.8.16` | `🏷️ v0.8.16` |\n| **config-count** | Config file counts | `📄 1 CLAUDE.md │ 📜 2 rules │ 🔌 3 MCPs` | — |\n| **cache-metrics** | Cache statistics | `💾 35.0k cache` | `💾 35.0k cache` |\n| **active-tools** | Active tools tracking | `Edits: 5 │ Bash: 3 │ Read: 2` | `✏️ Edit 📖 Read 🐚 Bash` |\n| **dev-server** | Dev server status | `⚡ Nuxt (running)` | `🏃 Nuxt` |\n| **docker** | Docker containers | `Docker: 3/5 🟢` | `🐳 Docker: 3/5 🟢` |\n| **poker** | Poker hands (easter egg) | `Hand: A♠ K♠ │ One Pair!` | `🃏 A♠️ K♠️ │ One Pair!` |\n\n### Layout Presets\n\n| Preset | Lines | Widgets |\n|--------|-------|---------|\n| **Rich** (default) | 3 | Line 0: model, context, lines, cost, duration\u003cbr\u003eLine 1: git, git-tag, cache-metrics, config-count\u003cbr\u003eLine 2: dev-server, docker, active-tools |\n| **Balanced** | 2 | Line 0: model, context, lines, cost, duration\u003cbr\u003eLine 1: git, git-tag, cache-metrics, config-count |\n| **Compact** | 1 | Line 0: model, context, cost, git, duration |\n\n---\n\n## Themes\n\n**Built-in themes** — from classic to futuristic:\n\n| Theme | Style | Colors |\n|-------|-------|--------|\n| `dracula` | Popular | Purple, pink, green |\n| `tokyo-night` | Modern | Blue, yellow, green |\n| `nord` | Cool | Arctic blues |\n| `monokai` | Vibrant | **DEFAULT** — bright accents |\n| `catppuccin-mocha` | Pastel | Soft dreamy colors |\n| `github-dark-dimmed` | Standard | GitHub's official dark |\n| `vscode-dark-plus` | Standard | VSCode's default |\n| `one-dark-pro` | IDE | Atom's iconic theme |\n| `solarized-dark` | Classic | Precise CIELAB lightness |\n| `rose-pine` | Pastel | Rose/violet themed |\n| `cyberpunk-neon` | Vibrant | Cyberpunk 2077 neon |\n| `professional-blue` | Professional | Business-oriented blue |\n| `gray` | Minimal | Neutral gray, minimal |\n| `muted-gray` | Muted | Very subtle grays |\n| `slate-blue` | Muted | Calm blue-grays |\n| `dusty-sage` | Muted | Earthy greens |\n| `semantic-classic` | Intuitive | Industry-standard colors |\n\n---\n\n## Configuration\n\n### Quick Config\n\nInteractive configuration menu:\n\n```bash\nclaude-scope quick-config\n```\n\nChoose from:\n- **Layout**: Rich (3 lines), Balanced (2 lines), Compact (1 line)\n- **Theme**: 17 themes with live preview\n- **Style**: balanced, playful, compact, verbose, technical...\n\n### Manual Configuration\n\nEdit `~/.claude-scope/config.json` directly:\n\n```json\n{\n  \"version\": \"1.0.0\",\n  \"$aiDocs\": \"https://github.com/YuriNachos/claude-scope/blob/main/AI-CONFIG-GUIDE.md\",\n  \"lines\": {\n    \"0\": [\n      { \"id\": \"model\", \"style\": \"balanced\", \"colors\": { \"name\": \"\\\\u001b[38;2;189;147;229m\" } },\n      { \"id\": \"context\", \"style\": \"balanced\", \"colors\": { \"low\": \"...\", \"medium\": \"...\", \"high\": \"...\" } }\n    ]\n  }\n}\n```\n\nSee [AI-CONFIG-GUIDE](AI-CONFIG-GUIDE.md) for complete configuration reference.\n\n---\n\n## Advanced Features\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eZero Runtime Dependencies\u003c/b\u003e\u003c/summary\u003e\n\nclaude-scope is written in pure TypeScript and uses only native Node.js modules. No external runtime dependencies — maximum performance and security.\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eLayout \u0026 Line System\u003c/b\u003e\u003c/summary\u003e\n\n- **Line 0**: Primary info (model, context, cost, duration, lines, git, dev-server, docker)\n- **Line 1**: Extended (git-tag, config-count)\n- **Line 2**: Activity (cache-metrics, active-tools)\n- **Line 4**: Poker widget (easter egg)\n- **Line 5**: Empty line widget\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eWidget System\u003c/b\u003e\u003c/summary\u003e\n\nEach widget implements the `IWidget` interface with lifecycle methods:\n- `initialize()` — Set up the widget\n- `render()` — Generate output\n- `update()` — Handle new data\n- `isEnabled()` — Check if active\n\nWidgets gracefully degrade on errors — if something fails, it returns `null`.\n\u003c/details\u003e\n\n---\n\n## Documentation\n\n| Topic | Link |\n|-------|------|\n| Architecture, data flow, providers | [ARCHITECTURE.md](docs/ARCHITECTURE.md) |\n| All widgets, styles, examples | [WIDGETS.md](docs/WIDGETS.md) |\n| Theme system, customization | [THEME-SYSTEM.md](docs/THEME-SYSTEM.md) |\n| Formatters, ANSI colors | [FORMATTERS.md](docs/FORMATTERS.md) |\n| Version history, roadmap | [CHANGELOG.md](docs/CHANGELOG.md) |\n\n---\n\n## Requirements\n\n- **Node.js** 18 or higher\n- **Claude Code** CLI\n\n---\n\n## License\n\n[MIT](LICENSE.md) — feel free to use this project in your own work!\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n  **Made with ❤️ by [YuriNachos](https://github.com/YuriNachos)**\n\n  [GitHub](https://github.com/YuriNachos/claude-scope) · [Issues](https://github.com/YuriNachos/claude-scope/issues) · [Contributing](CONTRIBUTING.md)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyurinachos%2Fclaude-scope","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyurinachos%2Fclaude-scope","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyurinachos%2Fclaude-scope/lists"}