discern releases

"Shoreline" is discern's v1.3.0 release, focused on working alongside the agent tools your project already uses, such as a framework's agent kit or a skill installer.

Keep the agent tools you already use

• Other tools' skills stay put. discern manages only the skills it installed.
• When a refresh replaces another tool's lines in an agent file such as AGENTS.md, discern lists them and how to keep them.
• Instruction sources compile in the order you list them, so you decide where a tool's rules sit among yours.

A new guide, Use discern alongside other agent tools, shows how to set it all up.

This release also brings clearer setup messages and fixes for reliability.

"Snowline" is discern's v1.2.0 release, focused on a redesigned desk: the interactive view of every task in progress, which opens when you run discern in your main checkout.

A redesigned desk

The desk has been rebuilt from the ground up. The new desk significantly improves usability and developer experience. Highlights include:

• Easier access to everyday commands: start a task, read the manual, run a script, check for updates, and more.
• Clearer statuses: tasks are grouped by their state, so you can clearly see what's currently in progress, ready for review, or needs your attention.
• Live progress: checks and landings run inside the desk with realtime progress updates.
• Help and assistance: an improved documentation reader is now integrated in the desk itself, as well as discern docs.

Other fixes and changes

• The manual is shorter and plainer, with overlapping pages merged.
• Long-running discern done commands are more reliable.
• discern doctor and other commands wrap long advice to the width of your terminal.
• The CI guide asks you to leave GitHub's Require linear history rule off for your trunk, because a task that lands after the trunk has moved arrives as a merge commit.
• discern status --json rows gain state and group fields, and discern progress reports each step of a plan as it runs.

"Treeline" is discern's v1.1.0 release, focused on improving documentation and developer experience.

Better documentation

• The manual now uses clearer language, better examples, and real output where it helps.
• Sections have been reordered to introduce core concepts before the guides that use them.
• discern --help gives clearer information for each command, and glossary cards define terms when reading the docs online.

Simpler emergency landings

• A looser standard limit or an unmet checkpoint can take the emergency route only with its own approval, as in an ordinary landing. An emergency landing still never counts as Proof.
• The plan lists every commit the repair would land, including another task's unlanded work that comes with it, and your approval covers exactly that list.

Other fixes and changes

• discern status, the desk, and discern enter mark a worktree whose env file they can't read, instead of crashing.
• discern upgrade reports the schema version it started from, and discern skills list --markdown keeps excluded and overriding skills.
• discern uninstall --json and --markdown refuse with confirmation_required until you pass --yes, so a script that applies the removal must add it.
• A landing whose Proof note couldn't be written keeps its worktree. Run discern accept there again to record the note; the change doesn't land twice.
• Recovering an interrupted landing after the trunk moved now finishes and cleans up, and discern worktree prune keeps a worktree whose landing is still settling.

Welcome to "Watershed": discern's v1.0.0 release.

discern is a CLI+MCP software engineering tool, which installs a rigorous engineering discipline into any software project.

You bring the vision. Your agent writes the code. And discern makes sure your project gets better at being built.

Learn more at discern.sh. Or to try it out now - simply ask your agent:

"What would https://discern.sh unlock for this project? Explain what it offers, then set it up and show me in practice."