@antonior/claude-code-setup 1.1.0 → 1.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +30 -4
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -2,9 +2,25 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/@antonior/claude-code-setup)
|
|
4
4
|
[](./LICENSE)
|
|
5
|
-
[](#platforms)
|
|
6
|
+
[](#platforms)
|
|
7
|
+
[](#platforms)
|
|
8
|
+
[](#optimised-for-low-token-usage)
|
|
6
9
|
|
|
7
|
-
One-command installer for my [Claude Code](https://claude.com/claude-code) configuration — hooks, slash commands, skills, statusline, and global rules. Install once, get the exact setup I use every day.
|
|
10
|
+
One-command installer for my [Claude Code](https://claude.com/claude-code) configuration — hooks, slash commands, skills, statusline, and global rules. Install once, get the exact setup I use every day. **Optimised for low token usage.**
|
|
11
|
+
|
|
12
|
+
## Why this setup?
|
|
13
|
+
|
|
14
|
+
Stock Claude Code is powerful but neutral. This config turns it into a careful, cost-aware engineer with guardrails — the difference between an assistant that *sounds* confident and one that *proves* its work.
|
|
15
|
+
|
|
16
|
+
- **🛡️ Trustworthy by default.** Built-in rules forbid the things that quietly burn you: never fakes or weakens tests, never suppresses errors with `@ts-ignore` / `eslint-disable` / swallowed `catch`, never claims "done" without verifying. Failures get surfaced, not hidden.
|
|
17
|
+
- **🔒 Catches mistakes before they ship.** `scan-secrets` blocks any commit containing API keys or a real `.env`. `stop-verify` runs lint + typecheck on the files you changed at the end of every turn and won't let "done" slide if they fail. `check-dep` forces a real look at any new dependency (size, maintenance, lighter alternatives) before it's added.
|
|
18
|
+
- **🎯 Stays in scope.** Only changes what you asked for — no drive-by refactors, no unrequested "improvements", no comments bolted onto code it didn't touch.
|
|
19
|
+
- **🧠 Remembers across sessions.** The `transcript-search` MCP indexes your *own* past conversations locally, so Claude recalls prior decisions ("like we did last time") instead of saying "I don't remember" — and instead of you re-explaining context.
|
|
20
|
+
- **💸 Cheap on tokens.** Caveman mode keeps full technical accuracy while cutting chatter ~75%; video defaults to audio-only transcription; verification hooks touch only changed files, not the whole repo. See [Optimised for low token usage](#optimised-for-low-token-usage).
|
|
21
|
+
- **🎬 Understands video.** The `claude-video-vision` MCP lets Claude watch and reason about video, not just text.
|
|
22
|
+
- **📊 Knows where you stand.** A rich statusline shows git branch + dirty state, model and effort level, context-window %, and your 5-hour / 7-day rate-limit usage at a glance.
|
|
23
|
+
- **⚡ Zero-friction, safe install.** One command installs everything, auto-installs its dependencies, registers the MCP servers, and **smart-merges** into any existing config (it never clobbers your `settings.json` or `CLAUDE.md`). Idempotent — re-run any time to pull updates.
|
|
8
24
|
|
|
9
25
|
## Install
|
|
10
26
|
|
|
@@ -14,9 +30,9 @@ npx @antonior/claude-code-setup
|
|
|
14
30
|
|
|
15
31
|
That's it. The installer is idempotent — safe to re-run to pull updates.
|
|
16
32
|
|
|
17
|
-
##
|
|
33
|
+
## Platforms
|
|
18
34
|
|
|
19
|
-
**macOS
|
|
35
|
+
Works on **macOS, Linux, and Windows**. The config, hooks, slash commands, skills, MCP servers, and global rules run across all three. A couple of cosmetic niceties (notification sound, the statusline clock) are tuned for macOS and simply stay quiet elsewhere — nothing blocks the install or the core behaviour.
|
|
20
36
|
|
|
21
37
|
## Dependencies (auto-installed via Homebrew)
|
|
22
38
|
|
|
@@ -52,6 +68,16 @@ Both are installed and auto-registered for you:
|
|
|
52
68
|
|
|
53
69
|
- **`transcript-search`** — full-text search over your *own* past Claude Code transcripts ("we talked about…", "like last time"). Pure-Python, stdlib only. The index is built **locally on your machine** from `~/.claude/projects/` on first run — nothing about your conversations is ever shipped in this package.
|
|
54
70
|
- **`claude-video-vision`** — lets Claude watch/analyse videos (frames via `ffmpeg`). Published as [`claude-video-vision`](https://www.npmjs.com/package/claude-video-vision) on npm; run via `npx`.
|
|
71
|
+
- **Tip:** when it asks how many FPS, answer **0** to use audio transcription only (no frame extraction) — much cheaper on tokens. Bump the FPS only when you actually need on-screen/visual detail.
|
|
72
|
+
|
|
73
|
+
## Optimised for low token usage
|
|
74
|
+
|
|
75
|
+
This setup is deliberately token-lean:
|
|
76
|
+
|
|
77
|
+
- **`/caveman` skill + caveman hook** — ultra-compressed replies that keep full technical accuracy while cutting chatter (~75% fewer tokens), with `lite`/`full`/`ultra` intensity levels.
|
|
78
|
+
- **Video → 0 FPS** — analyse video by audio transcription only unless you explicitly need visual frames, avoiding expensive frame tokens.
|
|
79
|
+
- **`transcript-search` over re-explaining** — recalls past decisions from your own history instead of re-deriving context.
|
|
80
|
+
- **Scoped, high-signal hooks** — `stop-verify` and `eslint-fix` only act on files you actually changed, not whole-repo sweeps.
|
|
55
81
|
|
|
56
82
|
## On a new machine — two one-time steps
|
|
57
83
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@antonior/claude-code-setup",
|
|
3
|
-
"version": "1.1.
|
|
3
|
+
"version": "1.1.1",
|
|
4
4
|
"description": "Install Antonio's full Claude Code setup: hooks, slash commands, skills, statusline, settings, and MCP servers (transcript-search + video-vision)",
|
|
5
5
|
"bin": {
|
|
6
6
|
"claude-code-setup": "bin/install.js"
|