@codeursenior/pek 0.1.10 → 0.1.11
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 +8 -5
- package/dist/browser/index.html +2 -2
- package/dist/browser/main-ZG5BUSN5.js +8 -0
- package/dist/browser/{styles-2QCIL5GS.css → styles-AWH5SAZF.css} +1 -1
- package/dist/scan/assets.js +17 -1
- package/dist/scan/metadata.js +3 -0
- package/dist/scanner.js +2 -2
- package/dist/token-estimator.js +69 -19
- package/docs/architecture.md +1 -1
- package/docs/token-optimizer.md +33 -10
- package/package.json +1 -1
- package/dist/browser/main-ITCUKQ5X.js +0 -8
package/README.md
CHANGED
|
@@ -20,10 +20,13 @@ Replace `npx @codeursenior/boyscout ui [folder]` with `npx @codeursenior/pek aud
|
|
|
20
20
|
|
|
21
21
|
## Explore
|
|
22
22
|
|
|
23
|
+
Token Optimizer is the home page. Return to it by clicking the avatar, agent name, or factory path. Rules and Optimization checklist are temporarily hidden from navigation.
|
|
24
|
+
|
|
25
|
+
- **Agent filter:** select one client using the icons below the avatar. The same selection applies to Context, Rules, Skills (including Whiteboard), MCP servers, and Token Optimizer. Click the selected icon again to show all agents. All agents are selected at startup. The project/user scope filter is restored from localStorage in this browser.
|
|
23
26
|
- **Context:** interactive graph with pan, zoom, draggable nodes, and file previews. Solid lines are explicit references; dashed lines show nested instruction scopes. Switch to Files for a table with line counts and client discovery. Filter by coding agent in either view.
|
|
24
27
|
- **Rules:** searchable list of dedicated Cursor, Claude Code, and GitHub Copilot instruction files, with source paths, declared file conditions, client discovery, and previews. Metadata does not prove a rule loaded in a session.
|
|
25
28
|
- **Skills:** names, descriptions, invocation policy, source paths, and discovery indicators for Cursor, Claude Code, Codex, and GitHub Copilot in VS Code. Identical copies in the same scope are grouped, retaining their paths.
|
|
26
|
-
- **Skills Whiteboard:** switch from
|
|
29
|
+
- **Skills Whiteboard:** switch from Files to Whiteboard to arrange every skill as a draggable card, connect your workflow with arrows, and add movable text titles. Solid blue arrows show explicit references in SKILL.md and cannot be edited. Dashed amber arrows are your local drawings: select one to delete it, drag its endpoints onto other cards, or change its From and To menus. All skills discoverable by the selected agent stay visible, including unused ones. Select a card and choose Open skill to inspect it; arrow keys move focused cards and titles. Pan, zoom and Fit skills help navigate larger inventories. Wheel and trackpad zoom stays anchored under the pointer and scales gradually with scroll distance; the zoom buttons use the center of the canvas. Use Fullscreen to expand the board across the browser viewport; Exit fullscreen or Escape restores the page without changing the composition.
|
|
27
30
|
- **MCP servers:** names, configuration sources, transport, and client indicators. The tool reads configuration without launching servers or transmitting credentials.
|
|
28
31
|
- **Project and User:** green and purple distinguish assets in the selected folder from assets in supported home-directory locations. Scope filters work in all views.
|
|
29
32
|
|
|
@@ -43,7 +46,7 @@ npx @codeursenior/pek audit agent --port 4317 --no-open
|
|
|
43
46
|
|
|
44
47
|
The default loopback port is **4242**, a nod to the answer in The Hitchhiker's Guide to the Galaxy. If it is occupied, close the other instance or pass `--port <number>`; the CLI does not silently change ports. Use `--port 0` to request an available port. The terminal URL includes a session token. Keep that URL private while the viewer is running.
|
|
45
48
|
|
|
46
|
-
Whiteboard positions, manual arrows and titles are automatically saved in **localStorage for each project**. They are local to this browser and port, and are lost if you clear its site data. Use the same browser and port to restore your board at the next launch. Switching between
|
|
49
|
+
Whiteboard positions, manual arrows and titles are automatically saved in **localStorage for each project**. They are local to this browser and port, and are lost if you clear its site data. Use the same browser and port to restore your board at the next launch. Switching between Files and Whiteboard keeps the composition. The global agent filter hides unrelated cards and their arrows without changing saved positions, titles, or drawings. Scope and search filters in the table do not hide whiteboard cards. Inventory and source arrows update only at startup or Rescan; added skills appear beside the existing layout, while removed skills and their attached arrows leave the board. Editing a skill's content preserves its position. No skill files are changed or executed by whiteboard drawings. File-based sharing such as `skill-map.json` is not implemented.
|
|
47
50
|
|
|
48
51
|
## Optional agent identity
|
|
49
52
|
|
|
@@ -59,7 +62,7 @@ Give the agent a name and avatar in the sidebar by adding either or both files t
|
|
|
59
62
|
|
|
60
63
|
Use `AVATAR.png` or `AVATAR.jpeg` for the image, up to 2 MiB. The file signature must match its extension. PNG takes priority when both files pass those checks. The image is cropped to a circle; if the browser cannot decode it, the default icon remains.
|
|
61
64
|
|
|
62
|
-
These are optional, independent settings: without a valid name, the sidebar
|
|
65
|
+
These are optional, independent settings: without a valid name, the sidebar uses the scanned folder name with its first letter capitalized; without an avatar, it keeps its default icon. The factory path appears below Agent Visualizer. Click **Rescan** after adding, changing or removing either file.
|
|
63
66
|
|
|
64
67
|
This is an internal Agent Visualizer convention, not an ecosystem standard or a configuration for other coding agents. Only `.agents/` directly under the selected root is used, with the exact filenames above; nested projects and home-directory identities are not inherited. Symlinks outside the selected project are ignored. Images are delivered with the authenticated scan, without an external image request or a public file route.
|
|
65
68
|
|
|
@@ -81,7 +84,7 @@ Codex behavior instructions in `AGENTS.md` stay in Context. Codex `.codex/rules/
|
|
|
81
84
|
|
|
82
85
|
Client icons show **file-based discovery**, not whether an application is installed, whether a skill's dependencies are available, or whether an asset is active in a particular conversation. Nested skills may only load when that client works in their folder. A skill outside recognized directories is listed with inactive client icons.
|
|
83
86
|
|
|
84
|
-
Claude/Cursor/Copilot `disable-model-invocation` and Claude/Copilot `user-invocable` frontmatter are read. Codex `agents/openai.yaml` policy `allow_implicit_invocation` is read separately. Hover an icon or open a skill to inspect per-client invocation. Legacy `.codex/skills` paths are identified in details.
|
|
87
|
+
Claude/Cursor/Copilot `disable-model-invocation` and Claude/Copilot `user-invocable` frontmatter are read. Codex `agents/openai.yaml` policy `allow_implicit_invocation` is read separately. Hover an icon or open a skill to inspect per-client invocation. Legacy `.codex/skills` paths are identified in details. Bundled skills under `.codex/skills/.system/` are attributed only to Codex; ordinary skills in `.codex/skills/` remain discoverable by Cursor through its compatibility imports.
|
|
85
88
|
|
|
86
89
|
## Honest limits
|
|
87
90
|
|
|
@@ -129,4 +132,4 @@ MIT © Simon Dieny. Independent project, not affiliated with Cursor, Anthropic,
|
|
|
129
132
|
|
|
130
133
|
## Token Optimizer
|
|
131
134
|
|
|
132
|
-
|
|
135
|
+
All agents are selected at startup. The home page estimates their combined startup and on-demand context, counting shared entries once. Select an agent below the avatar to narrow the estimate, compare one-load input costs using maintained model presets, and inspect the largest files and skills. The RTK checklist detects installation and provides manual installation instructions. These are static local estimates, not session usage or spending. See [the estimation method and limits](docs/token-optimizer.md).
|
package/dist/browser/index.html
CHANGED
|
@@ -5,8 +5,8 @@
|
|
|
5
5
|
<meta name="viewport" content="width=device-width, initial-scale=1"/>
|
|
6
6
|
<title>Agent Visualizer</title>
|
|
7
7
|
<link rel="icon" href="/favicon.svg"/>
|
|
8
|
-
<link rel="stylesheet" href="styles-
|
|
8
|
+
<link rel="stylesheet" href="styles-AWH5SAZF.css"></head>
|
|
9
9
|
<body>
|
|
10
10
|
<app-root ngcspnonce="__CSP_NONCE__"></app-root>
|
|
11
|
-
<script src="main-
|
|
11
|
+
<script src="main-ZG5BUSN5.js" type="module" nonce="__CSP_NONCE__"></script></body>
|
|
12
12
|
</html>
|