Agent-First Slug Blog
Updates, deep-dives, and release notes for Agent-First Slug.
Agent-First Slug v0.7: A Config That Describes Its Output
Three rules let a SlugConfig describe something other than what came out of it: case mapping ran after filtering, a delimiter could be a character the filter kept, and a fallback was validated against the target surface but never against the configuration it stood in for. All three are fixed, and two of them change generated slugs.
Agent-First Slug v0.6: A Shape, Not a Sentence
afslug's CLI is now compiled from a closed-world registry: one source for argv parsing, typed values, legal combinations, help, and docs/cli.md. clap is gone. The visible payoff is that a constraint which used to live in a help sentence and a runtime check is now a shape the parser enforces and `--help` lists.
Agent-First Slug v0.5: Discovery Without Guessing
An agent meeting a CLI for the first time does the same three things: asks what it can do, asks what version it is, and runs something. afslug answered the first two in prose an agent had to parse and the third by mixing results and errors into one stream. v0.5 makes all three structured. `afslug --help` returns a scoped result — this command level only, globals marked global, `--recursive` for the whole tree. `afslug --version` returns a result, not a sentence. And `--output-to` decides whether errors land on stderr beside the results or join them in one ordered stream.
Agent-First Slug v0.4: The Tool Installs Its Own Skill
A slug library is a few hundred lines; the hard part was never the transliteration table. v0.1 made every policy explicit at the call site so the code states which surface it targets. But explicit policy only pays off if the agent reaches for afslug and knows how it reasons — knowledge that used to sit in a README the agent might never open. v0.4 ships that knowledge as a skill the binary installs itself: `afslug skill install` drops the Agent-First Slug skill into Codex, Claude Code, opencode, or Hermes, bundling SKILL.md and its Codex agent interface as one tree. And `afslug --version` now answers in the shared structured protocol — name, display name, version, and the git SHA it was built from — the same shape every agent-first CLI reports.
Agent-First Slug v0.1.0
The first release of Agent-First Slug — a Rust slug library where every policy is set explicitly by the caller, with no hidden defaults that differ by surface.