claude-config-panel 0.0.0-stage → 0.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/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Carles Galan
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,450 @@
1
- # Temporary Holding Version
1
+ <div align="center">
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ <img src="https://raw.githubusercontent.com/Galan9999/claude-config-panel/main/docs/logo.svg" alt="" width="120" height="120">
4
+
5
+ # Claude Config Panel
6
+
7
+ **See everything Claude Code is configured to do — and what runs on its own.**
8
+
9
+ Your Claude setup is scattered across `~/.claude` and a `.claude/` folder in every repo.
10
+ There is no single screen that shows you all of it. This is that screen.
11
+
12
+ [![npm](https://img.shields.io/npm/v/claude-config-panel.svg?color=D97757)](https://www.npmjs.com/package/claude-config-panel)
13
+ [![CI](https://github.com/Galan9999/claude-config-panel/actions/workflows/ci.yml/badge.svg)](https://github.com/Galan9999/claude-config-panel/actions/workflows/ci.yml)
14
+ [![License: MIT](https://img.shields.io/badge/license-MIT-D97757.svg)](LICENSE)
15
+ [![Node](https://img.shields.io/badge/node-%E2%89%A518-5B8C51.svg)](package.json)
16
+ [![Dependencies](https://img.shields.io/badge/dependencies-0-5B8C51.svg)](package.json)
17
+ [![Tests](https://img.shields.io/badge/tests-247-5B8C51.svg)](test)
18
+
19
+ </div>
20
+
21
+ ```bash
22
+ npx claude-config-panel
23
+ ```
24
+
25
+ Open <http://127.0.0.1:7337>. Node 18+. Nothing to install, no dependencies, runs only on your machine.
26
+
27
+ No Node? **[Try it in your browser](https://claude-config-panel.vercel.app)**: you pick the folders, they are
28
+ read in the tab, and nothing is sent or saved anywhere.
29
+
30
+ <div align="center">
31
+ <img src="https://raw.githubusercontent.com/Galan9999/claude-config-panel/main/docs/overview.jpg" alt="Overview: every piece of Claude configuration grouped by type" width="820">
32
+ </div>
33
+
34
+ ---
35
+
36
+ ## Why
37
+
38
+ `/config` and `/permissions` cover a slice of it, and only in the terminal. Everything else means
39
+ opening JSON files by hand. So three questions stay unanswered:
40
+
41
+ - **What do I actually have?** Settings, skills, agents, commands, hooks and scheduled tasks, global
42
+ and per repo, in one place.
43
+ - **What does this rule really allow?** `Bash(node *)` reads as harmless. It lets Claude run any
44
+ script on your machine.
45
+ - **What runs without me?** Hooks and scheduled tasks act while you are not looking. That is the part
46
+ of your configuration that deserves the most attention and gets the least.
47
+
48
+ ---
49
+
50
+ ## What it does
51
+
52
+ ### Explains every permission in plain words
53
+
54
+ Each rule is translated, and the ones that are wider than they look get flagged.
55
+
56
+ | Rule | What the panel says |
57
+ |---|---|
58
+ | `Bash(git *)` | Can run git with any argument, without asking. |
59
+ | `Bash(node *)` | …**Careful: that allows running any script**, so in practice it is a very broad grant. → `broad` |
60
+ | `mcp__…__slack_send_message` | Acts outward: can send or change something in that service. → `outbound` |
61
+
62
+ <div align="center">
63
+ <img src="https://raw.githubusercontent.com/Galan9999/claude-config-panel/main/docs/permissions.jpg" alt="Permissions translated into plain language, with broad and outbound rules flagged" width="820">
64
+ </div>
65
+
66
+ ### Says why a rule should be the shape it is
67
+
68
+ Every rule carries a *why it is like this, and what else it could be* panel: which family the
69
+ command belongs to, what the prefix still admits once you look past the program's name, whether the
70
+ rule is in the right file, and the narrower rule that does the same job.
71
+
72
+ | Rule | Verdict | Because |
73
+ |---|---|---|
74
+ | `Bash(find *)` | `reconsider` | `find . -exec <anything> {} \;` runs that anything. It is an interpreter rule wearing a different name. |
75
+ | `Bash(npm run *)` | `narrow it` | Grants whatever `package.json` says those scripts mean today, and the repo can change them. |
76
+ | `Bash(gh pr *)` | `narrow it` | Covers `gh pr view` and, in the same breath, `gh pr merge` and `gh pr close`. |
77
+ | `Bash(ls *)` | `redundant` | Plain read-only commands never needed a rule. |
78
+ | `Bash(npm test)` | `reasonable` | No wildcard: it approves this command line and nothing adjacent. |
79
+
80
+ The **Permissions guide** view holds the reference behind those verdicts — how a Bash pattern is
81
+ matched (a prefix string, no flag analysis), what `allow` / `ask` / `deny` / `defaultMode` /
82
+ `additionalDirectories` each do, the command families, and six questions to ask before adding a
83
+ rule.
84
+
85
+ ### Says who decides in auto mode
86
+
87
+ A permission rule is not the last word. In auto mode the prompt never reaches you: the action goes
88
+ to a classifier on Anthropic's servers, which decides from rules of its own. The settings view spells
89
+ that out next to the mode selector — whether this file can grant `"auto"` at all (only
90
+ `~/.claude/settings.json`, a managed policy or `--permission-mode auto` can; the same value in a
91
+ repo's settings is ignored), whether `autoMode.classifyAllShell` is suspending every `Bash` rule,
92
+ and whatever `autoMode.{environment, allow, soft_deny, hard_deny, deny}` the file adds.
93
+
94
+ ### Surfaces what runs on its own
95
+
96
+ Hooks and scheduled tasks in one table: what triggers them, what they run, with what time limit.
97
+ This is how you find out you have two Prettier hooks firing on every single write.
98
+
99
+ ### Lists your mods
100
+
101
+ A mod is a change Claude Code makes to its own interface or behaviour: a panel, a band, a status
102
+ line entry, a toast, a slash command, a hook on tool calls. They live in `~/.claude/mods/<name>/`
103
+ and run as you. The **Mods** section reads each folder (`plugin.json`, `hooks/hooks.json` and the
104
+ hooks module) and shows its description, version, whether your settings load it, the commands, the
105
+ tools for the model and the hook events it registers, what it draws on, and whether it runs
106
+ processes, touches files or calls a model. It reads names from the source; it never runs a mod and
107
+ it does not edit one.
108
+
109
+ ### Separates MCP servers and routines
110
+
111
+ **MCP servers** has its own section, grouped by where each one is declared (`~/.claude.json`,
112
+ `.mcp.json`, a project): the command or URL and the *names* of the secrets it needs, never their
113
+ values.
114
+
115
+ **Routines** gathers everything that fires on a schedule, each with its definition: the local ones
116
+ in `~/.claude/scheduled-tasks`, the cloud ones from your claude.ai account (name, cron, state, next
117
+ and last run, connectors and prompt, redacted), and session loops. `/loop` and session cron jobs
118
+ live in a running session's memory, not in a file, so only the ones that were active when the
119
+ snapshot was generated can be shown. Cloud routines are not on disk either: the artifact edition
120
+ shows them when whoever generates the snapshot adds them.
121
+
122
+ ### Draws your command pipelines
123
+
124
+ Nothing to declare or install: it is a naming convention. **Two or more files in the same commands
125
+ folder whose name starts with `<number>.`** are read as the phases of one process. The number only
126
+ sets the order — they need not be consecutive nor start at 1, so you can leave gaps for phases you
127
+ add later.
128
+
129
+ ```
130
+ .claude/commands/deploy/
131
+ 1.check.md
132
+ 2.build.md
133
+ 3.ship.md
134
+ ```
135
+
136
+ That is enough for the panel to render `/deploy:*` as an SVG diagram generated from the files
137
+ themselves — no Mermaid, no CDN — showing each phase's model, which subagents it spawns, and **how
138
+ many actions it can take outside your machine without asking**. No folder is hardcoded; it works
139
+ with whatever you name yours.
140
+
141
+ If your commands are not a sequence, the section tells you so and explains the convention. It never
142
+ invents a flow that is not there.
143
+
144
+ <div align="center">
145
+ <img src="https://raw.githubusercontent.com/Galan9999/claude-config-panel/main/docs/flows.jpg" alt="A four-phase command pipeline drawn from the command files" width="820">
146
+ </div>
147
+
148
+ It also flags **drift**: commands referenced in documentation that no longer exist, and paths
149
+ mentioned that are not there. Documentation that describes a command nobody can run is a trap, and
150
+ this finds it the day it breaks instead of months later.
151
+
152
+ ### Maps how your agents talk to each other
153
+
154
+ The **Agent map** draws every piece that can start, call or watch another one — commands, skills,
155
+ subagents, hooks, mods, routines, MCP servers, chats with a role — and the arrows between them, read
156
+ from the files themselves. One arrow style per kind of interaction:
157
+
158
+ | Arrow | Means |
159
+ |---|---|
160
+ | opens a chat | a mod opens a new session in its own window (`open`, `open_group`) |
161
+ | invokes | `/x` or `Skill(x)`: the instructions load into the same context |
162
+ | delegates | `subagent_type: x`: a subagent works in its own context and returns a summary |
163
+ | fires a hook | a hook runs on an event or watches a tool, and can block or inject context |
164
+ | schedules | a desktop routine, launchd, `/loop` or `/schedule` starts it without you |
165
+ | calls an MCP | `mcp__server__tool`: Notion, Slack, GitHub… |
166
+ | shared state | a coordinator's `state.json` or a `.sdd/` folder the phases leave for one another |
167
+
168
+ An arrow is drawn only when the text says it in a form Claude Code acts on. When it rests on a bare
169
+ mention — an agent's name in prose, "Notion" with no tool call — it is drawn faint and marked
170
+ **assumed**. Four tabs:
171
+
172
+ - **Flow** — only what interacts, left to right. *Trace from here* keeps what one piece sets in motion.
173
+ - **Static** — every piece, one column per kind.
174
+ - **Live** — the chats running now, with their role and phase, if a coordinator keeps a
175
+ `.sdd/_conductor/state.json` in one of the scanned projects (or `--sdd-state <file>`). Read-only.
176
+ - **Audit** — broken `/ns:cmd` references, unknown `subagent_type`, calls into a repo the caller never
177
+ loads, names shadowed between global and a project, subagents nothing reaches (or only prose
178
+ does), hook matchers that match no tool, routines that will not run.
179
+
180
+ Filter by kind and by **scope**: everything, global only, one repo, or a repo *as Claude sees it
181
+ there* (global + that repo). Zoom with a pinch or ⌘/Ctrl + wheel, drag to move.
182
+
183
+ <div align="center">
184
+ <img src="https://raw.githubusercontent.com/Galan9999/claude-config-panel/main/docs/agent-map.jpg" alt="The agent map's flow view: a routine starts a coordinator that opens chats and runs a four-phase pipeline, with subagents, hooks and MCP calls" width="820">
185
+ </div>
186
+
187
+ ### Shows who built what
188
+
189
+ Per piece: who created it and when, who touched it since, how many lines each commit changed, and a
190
+ link to the commit. There is a profile per person with everything they created and everything they
191
+ touched afterwards.
192
+
193
+ It merges the same human across identities — work email, GitHub's
194
+ `12345+user@users.noreply.github.com`, the `user@MacBook-Air.local` of an unconfigured laptop — and
195
+ shows you which identities it merged, so you can spot a bad merge instead of trusting it.
196
+
197
+ For anything outside git — `~/.claude` is not a repo, `settings.local.json` files are gitignored —
198
+ it says so instead of inventing an author from a file timestamp.
199
+
200
+ ### Tracks whether a skill changes anything
201
+
202
+ A skill that never fires is dead weight. A skill that fires and changes nothing is worse, because
203
+ it reads like coverage. `claude plugin eval` answers both by running each case twice — with the
204
+ skill and without it — and the **delta** between the arms is the only number that means something.
205
+ A case that passes in both arms is measuring the base model.
206
+
207
+ The **Evals** tab finds every bench on disk (a folder with `.claude-plugin/plugin.json` and an
208
+ `evals/` directory — a `.claude/` folder is not a plugin, so the bench lives outside the repo and
209
+ symlinks the skill in rather than copying it) and shows, per case: score with, score without, the
210
+ delta, and how many runs actually invoked the skill. It separates the two failure modes: a low
211
+ score means the skill is wrong, `0/3` fired means it never ran.
212
+
213
+ | Case | with | without | Δ | fired |
214
+ |---|---|---|---|---|
215
+ | `1-positivo-contencion` | 1.00 | 0.00 | **+1.00** | 3/3 |
216
+ | `2-negativo-rojo-real` | 1.00 | 0.33 | +0.67 | 0/3 — correct: it should stay quiet |
217
+
218
+ It also costs the next run out of that bench's own history rather than a guess, flags a case with no
219
+ grader and a symlink that no longer resolves, and lists which skills have a bench and which do not.
220
+ Each skill's own page carries its delta, which is where it matters: when you are deciding whether
221
+ to keep, rewrite or delete it.
222
+
223
+ #### Agents too, with three rules that are not the skill ones
224
+
225
+ A bench can measure a subagent, and the panel reads those the same way — but getting one to run at
226
+ all turns on three things that cost real money to discover:
227
+
228
+ **The agent file has to be a copy, not a symlink.** The opposite of the rule for skills. A symlink
229
+ under `agents/` is silently not loaded: the plugin still resolves, the suite still runs, and every
230
+ case scores zero exactly as if the agent had failed its own rubric. The only trace is in the
231
+ model's own words — `Available agents: claude, Explore, general-purpose, …`, with your agent
232
+ missing. The panel flags a symlinked agent as **not loaded**, and because a copy goes stale it
233
+ hashes both files and flags a **stale copy** when the bench holds an older version than the one
234
+ you are reading.
235
+
236
+ **The dispatch name carries the plugin prefix** — `my-bench:code-reviewer`, not `code-reviewer`.
237
+ The bare name fails with `Agent type not found`, and the model will decline to substitute a
238
+ generic agent rather than pass it off as yours.
239
+
240
+ **Run it with `--ablation none`.** The baseline arm has no plugin, so it cannot dispatch your agent
241
+ even in principle: its score is zero every time and the Δ measures the absence of the plugin, not
242
+ the agent. Without a baseline the score is read in absolute, and the panel labels it `no baseline`
243
+ rather than the `no Δ` it shows for a bench that has genuinely never been compared.
244
+
245
+ What is worth measuring also differs. For a skill you measure the trigger, because the model
246
+ decides whether to load it. An agent dispatched by a slash command never faced that decision, so
247
+ the `tool_used: Agent` grader is a check that it really ran, not a metric — and the score belongs
248
+ on what the agent's contract adds that the base model lacks.
249
+
250
+ ### Reads your audits, next to what they are about
251
+
252
+ Point an auditing agent at a scope, have it write its report, and the panel shows each finding
253
+ beside the piece it concerns. Pieces with findings are marked in the listings, and a finding that
254
+ names a piece without living in its file is cross-referenced to it.
255
+
256
+ Reports live in `~/.claude/audits/<scope-slug>/<timestamp>.json` — **outside** the configuration
257
+ they are about. A report is an opinion about the config, not part of it: inside the repo it becomes
258
+ one more piece to audit, one more thing to gitignore or commit, and the next run overwrites the
259
+ last. The **Auditor** tab lists every scope the panel can see, audited or not, with its run history,
260
+ and keeps reading an older in-repo `.claude/audit/findings.json` so nothing already written is lost.
261
+ Scopes are keyed by the folder that owns the `.claude`, so a monorepo package like `apps/web` gets
262
+ its own audit rather than disappearing behind the repo it sits in.
263
+
264
+ A report can also carry **questions**: the things no amount of file-reading settles. A permission is
265
+ not wrong for being wide, it is wrong when nothing you do needs it that wide — and only you know
266
+ which. Each question names the exact rule, says what the answer decides, and offers the plausible
267
+ answers. The tab hands you a prompt that walks them one at a time and opens a PR with whatever you
268
+ agreed to.
269
+
270
+ No automatic patches and no automatic PRs. A patch that applies itself invites you to accept it
271
+ without reading it, which is the opposite of the point.
272
+
273
+ <div align="center">
274
+ <img src="https://raw.githubusercontent.com/Galan9999/claude-config-panel/main/docs/diagnostics.jpg" alt="Audit findings with severity, what happens and what to do" width="820">
275
+ </div>
276
+
277
+ > The screenshots show a sample configuration, not a real one.
278
+
279
+ ### Lets you edit
280
+
281
+ Markdown rendered, JSON validated, every save backed up first.
282
+
283
+ ---
284
+
285
+ ## Usage
286
+
287
+ ```bash
288
+ npx claude-config-panel # scan the usual project folders
289
+ npx claude-config-panel ~/my-repos # scan a specific folder
290
+ ```
291
+
292
+ | Option | What it does |
293
+ |---|---|
294
+ | `--port <n>` | Port to listen on (default 7337) |
295
+ | `--depth <n>` | How deep to look for `.claude/` folders (default 5 — enough for `<repo>/apps/<package>`) |
296
+ | `--worktrees` | Include linked worktrees, skipped by default because they duplicate their repo's config |
297
+ | `--sdd-state <file>` | The SDD coordinator's `state.json` for the agent map's live view (default: the first scanned project with `.sdd/_conductor/state.json`; also `CCP_SDD_STATE`) |
298
+ | `--help` | Usage |
299
+ | `CLAUDE_CFG_ROOTS=/a:/b` | Folders to scan, via environment variable |
300
+
301
+ With no arguments it looks for projects with a `.claude/` folder in the usual places (`~/code`,
302
+ `~/dev`, `~/projects`, `~/Desktop`, `~/Documents`…). Ctrl+C to stop.
303
+
304
+ The first time, the panel opens on **Sources**, where you choose what it reads:
305
+
306
+ - **Everything on this computer** — scans your whole home folder (skipping `Library`, caches,
307
+ `node_modules` and worktrees), then you untick the projects you do not want.
308
+ - **Only the folders I choose** — one path per line.
309
+ - **Let Claude Code find them** — a prompt to paste into Claude Code that lists the folders holding
310
+ configuration and what each has, without opening or changing anything.
311
+
312
+ Each project shows what it holds before you include it. The choice is kept in your browser and put
313
+ back when the server restarts; nothing is written to disk.
314
+
315
+ ---
316
+
317
+ ## Security
318
+
319
+ > [!IMPORTANT]
320
+ > This reads **and writes** your Claude configuration. Every save leaves a copy in
321
+ > `~/.claude/backups/config-dashboard/` first, but it is worth knowing before you start editing.
322
+
323
+ - **Listens on 127.0.0.1 only.** Never exposed to the network.
324
+ - **Checks where every request comes from.** Binding to localhost is not protection from your
325
+ browser: any open website can fire requests at it. With `content-type: text/plain` that would be a
326
+ simple request, no preflight, and the write would land even though the attacker cannot read the
327
+ response — and the first piece in the inventory is `~/.claude/settings.json`, where a hook runs by
328
+ itself in your next Claude session. So `Host` is validated (which also closes DNS rebinding),
329
+ `Origin` is validated, and `application/json` is required, forcing a preflight.
330
+ Regression tests live in [`test/server.test.mjs`](test/server.test.mjs).
331
+ - **Writes only to config files found during the scan.** Any other path is rejected.
332
+ - **Serves static files from `ui/` with no subfolders and no `..`**, so there is no path traversal.
333
+ - **Validates JSON before writing.** A malformed file never reaches disk.
334
+
335
+ Do not expose it beyond your own machine: it reads your Claude configuration, which can hold paths,
336
+ connector tokens and the contents of your scheduled tasks.
337
+
338
+ Thanks to **Lluís Filella** for catching the unauthenticated `POST`.
339
+
340
+ ---
341
+
342
+ ## The findings format
343
+
344
+ For an audit to be worth more than a read-through, its output needs a contract:
345
+ [`schema/findings.schema.json`](schema/findings.schema.json), validated by
346
+ [`src/findings.mjs`](src/findings.mjs).
347
+
348
+ <details>
349
+ <summary>Example report</summary>
350
+
351
+ ```json
352
+ {
353
+ "version": 1,
354
+ "generatedAt": "2026-10-21T16:40:00.000Z",
355
+ "tool": "auditor-config",
356
+ "scope": { "path": "~/repos/backend", "kind": "repo" },
357
+ "summary": "Drop Bash(bash *) from allow.",
358
+ "findings": [{
359
+ "id": "wildcard-bash-permission",
360
+ "severity": "alta",
361
+ "category": "permiso-amplio",
362
+ "title": "Bash(bash *) allows running any script",
363
+ "path": ".claude/settings.local.json",
364
+ "line": 4,
365
+ "what": "The rule lets any file be executed.",
366
+ "proposal": "Replace it with the three concrete invocations actually in use.",
367
+ "autofix": { "kind": "quitar-permiso", "file": ".claude/settings.local.json", "rule": "Bash(bash *)" }
368
+ }],
369
+ "notChecked": []
370
+ }
371
+ ```
372
+
373
+ </details>
374
+
375
+ Validation is strict on purpose: whatever produces this is a language model or a third-party tool.
376
+ Two rules that are not cosmetic:
377
+
378
+ - **`id` must be stable across audits.** That is what decides whether a finding opens a new ticket or
379
+ already has one.
380
+ - **A `proposal` starting with "review" is rejected.** It has to say what to do.
381
+
382
+ The format does not depend on this panel. Any auditor can emit it, and `cc-audit --format json` is a
383
+ candidate for an adapter.
384
+
385
+ ---
386
+
387
+ ## Development
388
+
389
+ No dependencies, runtime or dev. Everything it uses ships with Node: the server is `node:http` and
390
+ the tests are `node:test`.
391
+
392
+ ```bash
393
+ git clone https://github.com/Galan9999/claude-config-panel
394
+ cd claude-config-panel
395
+ npm start # run the panel
396
+ npm test # 185 tests
397
+ ```
398
+
399
+ <details>
400
+ <summary>Project layout</summary>
401
+
402
+ ```
403
+ bin/claude-config-panel.mjs CLI entry point
404
+ src/
405
+ cli.mjs Arguments, help, startup message
406
+ paths.mjs ~/.claude paths
407
+ fsutil.mjs Tolerant reads, frontmatter, script docs
408
+ git.mjs GitHub remote, repo root, worktree detection
409
+ history.mjs Authorship and changes, via git log
410
+ flows.mjs Numbered command pipelines and drift detection
411
+ findings.mjs Audit findings schema and cross-referencing
412
+ audits.mjs The audit store in ~/.claude/audits: runs, history, slugs
413
+ evals.mjs Eval benches, per-case deltas, coverage and run cost
414
+ discover.mjs Filesystem walk and piece catalogue
415
+ mods.mjs ~/.claude/mods, through the artifact scanner's reader
416
+ server.mjs HTTP routes, saving, backups
417
+ ui/
418
+ index.html The page
419
+ style.css Palette, with dark mode
420
+ app.js Navigation, listings, detail, editing
421
+ markdown.js Markdown renderer
422
+ permissions.js Translates a permission rule into a sentence
423
+ advice.js Why that rule, and the narrower one that would do
424
+ util.js HTML escaping and helpers
425
+ mods.js Reads what a mod registers (shared with the artifact scanner)
426
+ test/ Tests for the pure functions and the HTTP contract
427
+ ```
428
+
429
+ </details>
430
+
431
+ The interface lives in real `.html`, `.css` and `.js` files served as static assets.
432
+ `ui/markdown.js`, `ui/permissions.js` and `ui/advice.js` are DOM-free ES modules, so the Node tests
433
+ import exactly the same code the browser runs.
434
+
435
+ ## The artifact edition
436
+
437
+ `artifact/` is a version that runs as a page, without Node — [hosted on Vercel](https://claude-config-panel.vercel.app),
438
+ where nothing is saved, or as a claude.ai artifact, where each person's snapshot is kept privately: each person drops their folders and
439
+ the snapshot is read in the browser and kept in their own private space. It has the same views plus
440
+ **Mods**, **MCP servers** and **Routines**, lists pieces by kind and grouped by place (skills, agents,
441
+ commands, hooks declared in settings, hook scripts, scheduled tasks), and speaks **English, Spanish
442
+ and Catalan** (selector in the sidebar; a string not yet translated shows in English). The scanner
443
+ is shared with an optional Node collector. `node artifact/build.mjs` builds `artifact/dist/`, the
444
+ folder that gets published.
445
+
446
+ ---
447
+
448
+ ## License
449
+
450
+ MIT