Skip to main content

Agent Config

@maphew/agent-configv2026.10.16.2· MIT· 1mo agoBEHAVIORSACCEPTED WARNINGS
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.

02Behaviors1
@maphew/agent-configv2026.10.16.2src/agent_config.ts

Global Arguments

ArgumentTypeDescription
projectDir?stringSwamp repo root to inspect. Defaults to the current directory so the model stays portable across machines.
enrollmentManifest?stringRepo-relative enrollment manifest whose `tools:` list swamp manages
customToolsManifest?stringRepo-relative manifest holding custom tool definitions (overrides of the built-in defaults)
gitignoreFile?stringRepo-relative gitignore to check custom gitignore entries against
configDirs?arrayRepo-relative config directories that correspond to an AI tool
projectOwnedDirs?arrayConfig 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
ArgumentTypeDescription
outerTerminalstringouterTerminal id from terminal-probe
platformstringplatform from terminal-probe
multiplexerstringmultiplexer from terminal-probe
fn applyPiKeybindings(submitChord: string, newLineChord: string)
Idempotently merge the planned bindings into the pi keybindings.json
ArgumentTypeDescription
submitChordstringDesired tui.input.submit value
newLineChordstringDesired tui.input.newLine value
fn applyGhosttyConfig(keybindLine: string, fontFamily: string)
Idempotently merge font-family and the ctrl+enter unbind into the Ghostty config
ArgumentTypeDescription
keybindLinestringGhostty keybind line to merge
fontFamilystringDesired Ghostty font-family
fn applyXdgDefaultTerminal(desktopId: string)
Point xdg-terminal-exec at the desired desktop entry on Linux/GNOME; a recorded no-op elsewhere
ArgumentTypeDescription
desktopIdstringDesktop 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 Versions7
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

06Platforms
07Labels