Skip to main content
← Back to list
01Issue
BugOpenSwamp CLIPublic
AssigneesNone

Relationships

#3126 Session-start 'swamp model search --json' in the AGENTS.md template is unfulfillable - wire it to a hook or drop it

Opened by maphew · 10/7/2026

The managed AGENTS.md Getting Started section instructs the agent to run 'swamp model search --json' at the start of every conversation, and to read swamp-getting-started when it returns nothing.

Observed 2026-10-07 (myswamp, Kilo 7.8.3): the agent never ran it across a full implementation session. Two structural reasons:

  1. It is a permanent no-op on any instance that already has models provisioned - the check only matters on a fresh install, yet it is charged to every session.
  2. Hosted agents (Kilo) expose no session-start hook surface. kilo.json supports commands (user-invoked), agents, MCP servers, skills, and permissions, but no session-start event. The instruction has nothing to wire to; it can only be obeyed by agent goodwill, and it is not.

Local workarounds are dead ends: the section is regenerated by 'swamp repo upgrade', so deleting it locally is futile, and an MCP server started just to run the check is over-engineering.

Request: either provide a real session-start event/hook and wire the onboarding tripwire to it, or drop the instruction from the template and detect new users some other way.

02Bog Flow
◉OPEN○TRIAGED○IN PROGRESS○SHIPPED

Open

10/7/2026, 5:10:07 AM

No activity in this phase yet.

03Sludge Pulse

Sign in to post a ripple.