Skip to content

v0.3.6

Choose a tag to compare

View all tags
@github-actions github-actions released this 28 Aug 22:44
· 1 commit to main since this release
v0.3.6
a9d406c

dsx v0.3.6 — AGENTS.md guidance, one sync command

dsx now installs a small guidance block into your AGENTS.md alongside the companion skill, teaching droids two habits that only work when they're ambient: logging papercuts (dsx papercut add) when workflow friction costs time, and searching past sessions (dsx search) after two failed attempts at the same problem, before a third.

New: dsx sync (replaces dsx skill sync)

One command manages both companion assets:

dsx sync            # questionnaire: skill dirs + AGENTS.md files (choices remembered)
dsx sync --apply    # non-interactive: reapply saved choices, ask only new questions
dsx sync --force    # overwrite an AGENTS.md block you hand-edited

The installer runs dsx sync --apply on every install/update, so both assets refresh automatically. Without a terminal (agent/CI installs) it never prompts: defaults are ~/.agents/skills/dsx and ~/.agents/AGENTS.md, and it prints what it did. Deselecting an asset in the questionnaire removes it cleanly.

How the AGENTS.md block behaves

The guidance lives between <!-- dsx:begin <hash> --> and <!-- dsx:end --> markers:

  • Move it anywhere. Updates replace the block in place; position in your file is yours.
  • Hand-edits are safe. The marker hash detects edits inside the block; sync then skips that file and tells you (--force overwrites). Everything outside the block is never touched.
  • Missing paths are created, including the file itself if you have no AGENTS.md yet.
  • Removing the block by hand and re-running dsx sync re-adds it; deselect it in the questionnaire instead.

Migration notes

  • dsx skill sync is gone (including --to); use dsx sync. Your saved skill choice carries over: skill-prefs.json is read once and migrated to sync-prefs.json.
  • Existing installs get the new AGENTS.md question defaulted on the next non-interactive update, or asked on the next interactive dsx sync.

Verification

62 tests (block create/append/in-place update/idempotence/edit-skip/force/removal, prefs migration), typecheck, compiled-binary smoke tests of the non-tty flow, legacy prefs migration, and idempotence against a real, reorganized AGENTS.md.

Assets 6
Loading