data-goblin

Claude Goblin — Development skill for Claude Code

Development community

Python.

How to install Claude Goblin

This entry records only its repository, not the path inside it, so there is no exact command to give. Open data-goblin/claude-goblin and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claude Goblin does

Python.

Alternatives in Development

MCP Python SDK — Python SDK for building MCP servers 22.3k ★
Pyright Lsp — Python /plugin install pyright-lsp@claude-plugins-official 14k ★
Claude Code SDK Python — The official Python SDK for Claude Code 5.6k ★

README

Claude Code Goblin

![Python](https://img.shields.io/badge/python-3.10%2B-blue?logo=python&logoColor=white) ![Claude Code](https://img.shields.io/badge/Claude%20Code-required-orange?logo=anthropic) ![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey) ![License](https://img.shields.io/badge/license-MIT-green)

[!WARNING] This project is in active development (pre-1.0.0). Issues are not actively tracked until version 1.0.0 is released. Features may change without notice.

Python command line tool to help with Claude Code utilities and Claude Code usage analytics and long-term tracking.

**Quick Start:** Install with `pip install claude-goblin` and use `ccg --help` for commands or `ccg usage` to start tracking. Below are some examples of outputs that this command line can give you.

[!NOTE] Both `claude-goblin` and `ccg` work interchangeably as command aliases.

Example outputs

**TUI Dashboard:**

![Example TUI dashboard](docs/images/dashboard.png)

**GitHub activity-style heatmap of annual usage:**

![Example heatmap](docs/images/heatmap.png)

[!NOTE] This tool was developed and tested on macOS (Python 3.13). Should work on Linux and Windows but is untested on those platforms.

Features

Local snapshotting of Claude Code logs for analytics
Dashboard and stats of usage history
Project anonymization for sharing screenshots (--anon flag)
Hook setup to automate data logging or analysis of Claude Code
Audio notifications for Claude Code completion, permission requests, and conversation compaction
Text-to-speech (TTS) notifications with customizable hook selection (macOS only)
Devcontainer setup for safe --dangerously-skip-permissions execution

Installation

From PyPI (recommended)

# Install from PyPI (uv recommended)
uv pip install claude-goblin

# Or with pip
pip install claude-goblin

# Optional: Install export dependencies for PNG/SVG generation
uv pip inst