Skip to content

Commit 3eabc4d

Browse files
committed
Add commands
1 parent 0538ca5 commit 3eabc4d

4 files changed

Lines changed: 229 additions & 0 deletions

File tree

assets/commands/ccc.md

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
# TAGLINE
2+
3+
ContextCodeCache generator for AI coding agents
4+
5+
# TLDR
6+
7+
**Scan a project and generate the cache**
8+
9+
```ccc scan```
10+
11+
**Scan and also produce a token stream**
12+
13+
```ccc scan . --tokens```
14+
15+
**Check whether the committed cache is up to date (CI)**
16+
17+
```ccc check .```
18+
19+
**Install the binary to PATH (Linux)**
20+
21+
```ccc install```
22+
23+
# SYNOPSIS
24+
25+
**ccc** scan [_PATH_] [--tokens]
26+
27+
**ccc** check [_PATH_] [--format json]
28+
29+
**ccc** tokenize [_PATH_]
30+
31+
**ccc** install [--dir DIR] [--force]
32+
33+
# DESCRIPTION
34+
35+
ccc scans a source tree and produces a compact, machine-readable `.ccc/` directory containing per-file summaries: constants, functions (with types and doc summaries), call-graph edges inside the file, and marker comments (TODO, FIXME, etc.).
36+
37+
The cache is designed to be committed and consumed by AI agents so they have a cheap, always-fresh structural index instead of repeatedly grepping or re-reading source.
38+
39+
Supported languages: Rust, Python, JavaScript, TypeScript, Go.
40+
41+
# INSTALL
42+
43+
cargo build --release
44+
./target/release/ccc install
45+
46+
The `ccc install` subcommand copies the binary to `~/.local/bin` (or a directory you choose).
47+
48+
# PARAMETERS
49+
50+
**scan**
51+
> Regenerate the `.ccc` directory for the given path (defaults to current directory).
52+
53+
**--tokens**
54+
> Also emit a pre-encoded token stream (tokens.bin + tokens.json) for models that can consume raw token IDs.
55+
56+
**check**
57+
> Exit non-zero if the on-disk cache is stale relative to current sources. Useful in CI.
58+
59+
**--format json**
60+
> Machine-readable output listing changed files.
61+
62+
# CAVEATS
63+
64+
The token stream uses approximate tiktoken IDs and is noted as such; it is not guaranteed to match Anthropic tokenizers exactly. Use the Markdown form of the cache with Claude.
65+
66+
Regenerate the cache whenever source files that affect the index change.
67+
68+
# SEE ALSO
69+
70+
[colwill/ccc](https://github.com/colwill/ccc)
71+
72+
```[Source code](https://github.com/colwill/ccc)
73+
<!-- verified: 2026-07-04 -->
74+
```

assets/commands/index.txt

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1052,6 +1052,7 @@ cbt.md
10521052
cc.md
10531053
ccache.md
10541054
ccat.md
1055+
ccc.md
10551056
ccgs.md
10561057
ccomps.md
10571058
ccrypt.md
@@ -4351,6 +4352,7 @@ mcookie.md
43514352
mcopy.md
43524353
mcp-postgres.md
43534354
mcp-probe.md
4355+
mcpsnoop.md
43544356
mcptube.md
43554357
mcs.md
43564358
md5sum.md
@@ -6593,6 +6595,7 @@ ri.md
65936595
rich.md
65946596
riff.md
65956597
rig.md
6598+
rigorix.md
65966599
rip.md
65976600
ripd.md
65986601
ripgrep.md

assets/commands/mcpsnoop.md

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
# TAGLINE
2+
3+
Wireshark for MCP – transparent proxy and live TUI for AI client/server traffic
4+
5+
# TLDR
6+
7+
**Wrap a server** to inspect live MCP (Model Context Protocol) JSON-RPC traffic
8+
9+
```mcpsnoop -- node build/index.js```
10+
11+
**Run the demo**
12+
13+
```mcpsnoop demo```
14+
15+
**Proxy an HTTP MCP server**
16+
17+
```mcpsnoop http --target http://localhost:3000/mcp --listen :7000```
18+
19+
**Start the TUI** (pairs automatically with wrapped servers)
20+
21+
```mcpsnoop```
22+
23+
# SYNOPSIS
24+
25+
**mcpsnoop** [--] [_server_ _args_...]
26+
27+
**mcpsnoop** http [--target _url_] [--listen _addr_]
28+
29+
**mcpsnoop** demo
30+
31+
# DESCRIPTION
32+
33+
mcpsnoop is a transparent proxy and interactive terminal UI for debugging traffic between AI clients (Claude Desktop, Cursor, Claude Code, etc.) and MCP servers. Unlike the official MCP Inspector, which connects as a separate client, mcpsnoop sits in the actual data path so it sees the real calls made by your client.
34+
35+
It consists of two cooperating roles in one binary:
36+
37+
- The shim (`mcpsnoop -- <server command>`) that your client spawns. It forwards bytes verbatim while capturing every JSON-RPC frame.
38+
- The hub/TUI (`mcpsnoop` with no arguments) that receives frames and provides a live, filterable, replay-capable interface.
39+
40+
The two halves discover each other automatically via a well-known socket and on-disk logs; order of starting does not matter.
41+
42+
# FEATURES
43+
44+
- Live colour-coded JSON-RPC stream (requests, responses, notifications, server stderr)
45+
- Hung-call detection with live timers
46+
- Capability inspector
47+
- Frame inspector with search
48+
- Replay of any captured tool call against a fresh server copy
49+
- Powerful filter query language (`tool:`, `status:`, `dir:`, etc.)
50+
- Single static binary, zero runtime dependencies
51+
52+
# INSTALL
53+
54+
go install github.com/kerlenton/mcpsnoop/cmd/mcpsnoop@latest
55+
56+
Or via Homebrew:
57+
58+
brew tap kerlenton/mcpsnoop
59+
brew install mcpsnoop
60+
61+
Prebuilt binaries are available from the Releases page.
62+
63+
# PARAMETERS
64+
65+
**--**
66+
> End flag processing; everything after is the wrapped server command and its arguments.
67+
68+
For the HTTP reverse-proxy mode:
69+
70+
**--target** _url_
71+
> Target HTTP MCP endpoint.
72+
73+
**--listen** _addr_
74+
> Address to listen on (e.g. `:7000`).
75+
76+
# CAVEATS
77+
78+
Only wrap servers you trust. mcpsnoop executes the command you configure. The tool is pre-1.0; behaviour may change in minor releases.
79+
80+
# SEE ALSO
81+
82+
[modelcontextprotocol/inspector](https://github.com/modelcontextprotocol/inspector)
83+
84+
```[Source code](https://github.com/kerlenton/mcpsnoop)
85+
<!-- verified: 2026-07-04 -->
86+
```

assets/commands/rigorix.md

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
# TAGLINE
2+
3+
Deterministic coding-agent runtime that compiles intent into executable DAGs
4+
5+
# TLDR
6+
7+
**Initialize a project**
8+
9+
```rigorix init```
10+
11+
**Generate and review a plan** before executing
12+
13+
```rigorix plan "Add a new API endpoint"```
14+
15+
**Run a task**
16+
17+
```rigorix run "Refactor the user module"```
18+
19+
**Show the dashboard / interactive TUI**
20+
21+
```rigorix```
22+
23+
# SYNOPSIS
24+
25+
**rigorix** [_options_] <command> [_args_...]
26+
27+
Common commands: init, plan, run, update
28+
29+
# DESCRIPTION
30+
31+
Rigorix turns natural-language development tasks into deterministic, auditable Directed Acyclic Graphs (DAGs). Planning is separated from execution: an LLM generates a plan according to templates; Rigorix validates the plan, then executes it under policy, permission, and budget controls.
32+
33+
Key benefits over open-ended agent loops:
34+
35+
- Repeatable execution graphs
36+
- Explicit quality gates and policy enforcement
37+
- Full audit trail
38+
- Safe to run in CI/CD contexts
39+
40+
It supports Rust, TypeScript, Python and Go codebases (TypeScript is the most mature).
41+
42+
# INSTALL
43+
44+
cargo install --git https://github.com/arman-jalili/rigorix-oss rigorix-cli
45+
46+
Or build from source and place the rigorix binary on your PATH.
47+
48+
Set your LLM API key, e.g.:
49+
50+
export RIGORIX__LLM__API_KEY="sk-ant-..."
51+
52+
# PARAMETERS
53+
54+
Most configuration lives in the project after `rigorix init`. Command line flags control planning vs. execution, provider selection, and non-interactive mode.
55+
56+
# CAVEATS
57+
58+
Rigorix is intentionally less flexible than free-form chat agents. It excels at repeatable, governed workflows rather than exploratory conversation.
59+
60+
# SEE ALSO
61+
62+
[arman-jalili/rigorix-oss](https://github.com/arman-jalili/rigorix-oss)
63+
64+
```[Source code](https://github.com/arman-jalili/rigorix-oss)
65+
<!-- verified: 2026-07-04 -->
66+
```

0 commit comments

Comments
 (0)