Skip to content

Docs: automatic modes, context_modes, hidden_modes - #17

Merged
vgreg merged 1 commit into
mainfrom
13-docs
Aug 1, 2026
Merged

Docs: automatic modes, context_modes, hidden_modes#17
vgreg merged 1 commit into
mainfrom
13-docs

Conversation

@vgreg

@vgreg vgreg commented Aug 1, 2026

Copy link
Copy Markdown
Owner

Documentation pass for the automatic mode switching work (#8, #9, #10, #12).

What changed

  • New page docs/configuration/automatic-modes.md — the ~/.config/padio/context mechanism, the four resolution rules, hidden modes, the producer contract, and herdr as one producer among others. Framed as a general extension point: anything that can write a file can drive PadIO's mode.
  • docs/configuration/profiles.mdcontext_modes and hidden_modes added to the profile field table, plus automatic switching listed alongside the manual mode switchers.
  • config.json and docs/example-config.md — the terminal profile gains context_modes, hidden_modes, and an agent mode that is reachable only via context.
  • README.md — one feature bullet.
  • mkdocs.yml — nav entry.

Verified

  • mkdocs build --strict passes with no warnings.
  • Both the sample config and the JSON embedded in the example page parse, and every context_modes / hidden_modes entry resolves to a mode that exists.
  • Documented behaviour was read off the merged implementation rather than the plan. In particular hidden_modes filters prev_mode / next_mode cycling as well as the picker, which the issue did not anticipate, and that is now documented.

One correction made along the way: an early draft used a text action type that does not exist. Text injection is a keystroke with a backtick-delimited key, which is what shipped.

Closes #13

🤖 Generated with Claude Code

Add a configuration page covering the ~/.config/padio/context extension point,
the four resolution rules, and hidden modes, with the herdr plugin as one
producer rather than the only one. Extend the profile field table, the sample
config, and the annotated example with an agent mode reached only via context.

Closes #13

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@vgreg
vgreg merged commit f054948 into main Aug 1, 2026
@vgreg
vgreg deleted the 13-docs branch August 1, 2026 21:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs: context_modes, hidden modes, herdr integration

1 participant