Agent Config
@maphew/agent-configv2026.10.16.2
01README
Inventories enrolled AI-tool configs in a swamp repo and reports drift between the enrollment manifest (.swamp.yaml tools:), the custom-tool definitions (.swamp-custom-tools.yaml), and on-disk state. Distinguishes a tool that is merely un-customised from one that is genuinely missing or orphaned.
02Behaviors
@maphew/agent-configv2026.10.16.2src/agent_config.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| projectDir? | string | Swamp repo root to inspect. Defaults to the current directory so the model stays portable across machines. |
| enrollmentManifest? | string | Repo-relative enrollment manifest whose `tools:` list swamp manages |
| customToolsManifest? | string | Repo-relative manifest holding custom tool definitions (overrides of the built-in defaults) |
| gitignoreFile? | string | Repo-relative gitignore to check custom gitignore entries against |
| configDirs? | array | Repo-relative config directories that correspond to an AI tool |
| projectOwnedDirs? | array | Config directories the project maintains by hand rather than delegating to swamp. Listed here so they are not reported as unmanaged. |
fn inventory()
Inventory enrolled AI tool configs and write a markdown report
fn checkDrift()
Report only the drift findings between enrollment, custom definitions, and disk
fn probeTerminalChain()
Probe the terminal input chain: outer terminal, multiplexer, platform and modified-Enter capability
fn readDefaultTerminal()
Read the gsettings indirection and what xdg-terminal-exec would launch today (read-only)
fn planKeymap(outerTerminal: string, platform: string, multiplexer: string)
Turn a probe classification into the effective submit/newline chords and exact config snippets
| Argument | Type | Description |
|---|---|---|
| outerTerminal | string | outerTerminal id from terminal-probe |
| platform | string | platform from terminal-probe |
| multiplexer | string | multiplexer from terminal-probe |
fn applyPiKeybindings(submitChord: string, newLineChord: string)
Idempotently merge the planned bindings into the pi keybindings.json
| Argument | Type | Description |
|---|---|---|
| submitChord | string | Desired tui.input.submit value |
| newLineChord | string | Desired tui.input.newLine value |
fn applyGhosttyConfig(keybindLine: string, fontFamily: string)
Idempotently merge font-family and the ctrl+enter unbind into the Ghostty config
| Argument | Type | Description |
|---|---|---|
| keybindLine | string | Ghostty keybind line to merge |
| fontFamily | string | Desired Ghostty font-family |
fn applyXdgDefaultTerminal(desktopId: string)
Point xdg-terminal-exec at the desired desktop entry on Linux/GNOME; a recorded no-op elsewhere
| Argument | Type | Description |
|---|---|---|
| desktopId | string | Desktop entry id to prefer |
fn verifyGhosttyConfig()
Run ghostty +show-config and check the ctrl+enter line disappeared and the font resolved
fn terminalReport()
Render a markdown summary of the latest terminal-keymap probe/plan/apply/verify run
Resources
inventory(7d)— Per-tool on-disk state versus enrollment and customisation
drift(7d)— Drift findings between enrollment, custom definitions, and disk
terminalProbe(7d)— Detected terminal input chain
xdgDefaultTerminalCurrent(7d)— Current gsettings + xdg-terminal-exec default terminal state
keymapPlan(7d)— Effective keymap chords and config snippets
piKeybindings(infinite)— pi keybindings.json apply result
ghosttyConfig(infinite)— Ghostty config apply result
xdgDefaultTerminal(infinite)— xdg-terms.list apply result
ghosttyVerify(7d)— Parsed Ghostty config verification
Files
report(text/markdown)— Markdown agent tool config report
terminalReport(text/markdown)— Markdown terminal-keymap-setup run summary
03Previous Versions
2026.10.16.1MIT
2026.10.15.3MIT
Modified 1 behaviors
2026.10.15.2MIT(was AGPL-3.0-only)
Relicense from AGPL-3.0-only to MIT.
2026.10.15.1AGPL-3.0-only(was none)
Declare license: AGPL-3.0-only in the manifest; no model, workflow, or schema changes.
2026.10.14.1
updated labels
2026.09.29.2
2026.09.28.1
04Stats
A
100 / 100
Downloads
31
Archive size
30.4 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License2/2earned
- Verified public repository2/2earned
deno-command1 accepted
Spawns a subprocess with Deno.Command().
- models/src/agent_config.ts:979 — no reason given
06Platforms
07Labels