notchi

Name: notchi
Author: sk-ruban

by sk-ruban

Verified

notch app for claude code & codex

1,024stars

76forks

Swift

Added 3/10/2026

Installation

# Add to your Claude Code skills
git clone https://github.com/sk-ruban/notchi

Getting Started

Guides for using ai agents skills like notchi.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 5/5/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-05-05T06:18:35.262Z",
  "semgrepRan": false,
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is notchi?

notchi is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by sk-ruban. notch app for claude code & codex. It has 1,024 GitHub stars.

Is notchi safe to use?

Yes. notchi passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install notchi?

Clone the repository with "git clone https://github.com/sk-ruban/notchi" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is notchi written in?

notchi is primarily written in Swift. It is open-source under sk-ruban on GitHub, so you can review or fork the full source.

Are there alternatives to notchi?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh notchi against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

255,402

GLM-5.3-Flash-J-Space-Capability-Realization-Report arcade-mcp

⚠️ Third-Party Software Notice

This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.

Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.

Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.

Read the Terms of Service

Notchi

A macOS notch companion that reacts to Claude Code and Codex activity in real-time.

https://github.com/user-attachments/assets/e417bd40-cae8-47c0-998a-905166cf3513

What it does

Reacts to Claude Code and Codex events in real-time (thinking, working, permission requests, compaction, errors, completions)
Analyzes prompt sentiment via Anthropic or OpenAI APIs to show emotions (happy, elated, sad, neutral, sob)
Click to expand and see session time and usage quota
Tracks daily cost and token usage over the last 30 days, per provider or combined
Supports multiple concurrent sessions, each with its own mascot from the Claude or Codex sprite family
Sound effects for events with support for importable custom sounds (optional, auto-muted when terminal is focused)
Available in English, 日本語, 简体中文 / 繁體中文, 한국어, and Tiếng Việt (follows your system language)
Auto-updates via Sparkle

Requirements

macOS 15.0+ (Sequoia)
MacBook with notch
Claude Code and/or Codex installed

Install

Download the latest DMG (all versions are on the releases page)
Open the DMG and drag Notchi to Applications
Launch Notchi, it auto-installs Claude Code and Codex hooks on first launch (whichever are present)
If a macOS keychain popup appears asking for access (used for API usage stats), click Always Allow so it won't prompt again
(Optional) Click the notch to expand → open Settings → paste your Anthropic or OpenAI API key. This enables sentiment analysis of your prompts so the mascot reacts emotionally
Start using Claude Code or Codex and watch Notchi react
Track usage by clicking on the usage bar

How it works

Claude Code / Codex --> Hooks (shell scripts) --> Unix Socket --> Event Parser --> State Machine --> Animated Sprites

Notchi registers shell script hooks with Claude Code and Codex on launch. When either agent emits events (tool use, thinking, prompts, permission requests, compaction, session start/end), the hook script sends JSON payloads to a Unix socket. The app parses these events, runs them through a state machine that maps to sprite animations (idle, working, sleeping, compacting, waiting), and uses Anthropic or OpenAI to analyze user prompt sentiment for emotional reactions.

Each session gets its own sprite on the grass island, drawn from the Claude or Codex sprite family depending on which agent it came from. Clicking expands the notch panel to show a live activity feed, session info, and Claude/Codex usage stats.

Contributing

If you have any bugs, ideas, or would like to contribute through pull requests, please check out Contributing to Notchi.

Support

Notchi is free and open source. If it's useful to you, you can sponsor development, which helps cover the Apple Developer account that keeps builds signed and notarized.

Community Ports

notchi-for-windows by @AptatoX, a community-made Windows port of Notchi
pixel-companion by @Emi-Dz, a community-made Windows desktop companion inspired by Notchi

Credits

Claude Island: design inspiration for the app
Readout: design inspiration for notchi.app
Aseprite: sprite design

License

GPL-3.0-only. See LICENSE.