§ Project

Roadmap

murli is at v1.0.2. The current release delivers complete Go support across three CLI frameworks. Chapter 2 begins when v1.0 stabilises in production use.

v1.0.2 — current

Patch release: developer diagnostics gated behind a build tag to keep the agent-facing command surface clean.

Change	Detail
`doctor` subcommand	Moved to `-tags murlidev`; excluded from release builds by default
`CheckConventions`	Moved to `-tags murlidev`; no-op stub in release builds

v1.0.2

The Go implementation is complete and stable.

Feature	Notes
TTY detection and output routing	Automatic; no handler code required
`--agent` flag	Forces JSON output at a TTY
`--schema` on every command	Auto-injected by `Execute` / `Run` / `Wrap`
`describe` subcommand	Full command tree as JSON; auto-mounted
`doctor` subcommand	Health and config check; requires `-tags murlidev` as of v1.0.2
`profile` subcommand	Profile management; auto-mounted
Structured `AgentError`	Exit codes 0–9, all fields
`Metadata` annotations	`AgentDescription`, `WhenToUse`, `Idempotent`, `Returns`, `Examples`
`FlagAnnotation`	`Sensitive`, `Profileable`, `Enum`, `MutuallyExclusiveWith`, `Pattern`
`WriteProgress` / `WriteEvent`	NDJSON streaming with typed `ProgressEvent`
`WritePlan`	Dry-run plan envelopes
Log deduplication	Consecutive identical lines collapsed
`CheckConventions`	Advisory linter for verb and flag names; requires `-tags murlidev` as of v1.0.2
`FormatAgentsMD`	AGENTS.md stub generation from describe output
cobra adapter	`spf13/cobra v1.8+`
urfave/cli v2 adapter	`urfave/cli v2.27+`
urfave/cli v3 adapter	`urfave/cli v3.9+`

Chapter 2 — language adapters

Each implementation ships its own module or package with framework-idiomatic signatures, sharing the same wire format and design principles as the Go reference.

Language	Frameworks	Package	Status
Rust	clap (derive + builder), argh	murli-cli/murli-rs	stable
Python	click, typer, argparse	murli-cli/murli-py	stable
TypeScript	commander, yargs, oclif, citty	—	planned

Track progress at github.com/murli-cli.

Background on the design decisions behind murli: allankent.com/garden/projects/murli