aht-cli

Use when you need to batch inspect or edit Markdown or Typst headings, tags, remarks, subtree order, or exports through the local `aht` CLI instead of the VS Code UI. Trigger on requests to normalize heading comments, set tags or remarks, move headings, delete heading blocks, shift heading levels, or export Typst subtrees.

Jump to install

Repository: ffy6511/Adjust-heading-in-tree
Last source activity: April 30, 2026 at 09:26
Detected SKILL.md language: English
Stars: 2
Forks: 1

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/ffy6511/Adjust-heading-in-tree --skill aht-cli

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

2 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

AHT CLI

Use the local aht CLI as the primary interface for non-UI heading operations.

Workflow

Confirm the target file path first. Always pass --file.

For discovery, run aht list --file <path> --json.

For edits, prefer a preview run first. Add --write only after checking the result.

For ambiguous targets, use line:, text:, tag:, or path: selectors. Use --interactive when a human is driving.

For delete and move, operate on one file at a time.

Command patterns

List headings: aht list --file note.md --json

Normalize inline comments to next-line comments: aht normalize --file note.md aht normalize --file note.md --write

Set tags: aht tags set --file note.md --selector 'text:Alpha' --tags Review,Spark

Set or clear a remark: aht remark set --file note.md --selector 'line:12' --text 'follow up' aht remark set --file note.md --selector 'line:12' --text '' --write

Shift a subtree: aht shift --file note.md --selector 'path:Alpha > Beta' --by 1 --write

Move a subtree: aht move --file note.md --selector 'text:Gamma' --before 'text:Alpha' --write

Delete a subtree: aht delete --file note.md --selector 'tag:Todo'

Export a Typst subtree: aht export --file note.typ --selector 'text:Alpha' --format pdf --output alpha.pdf

Read references/commands.md when you need a compact selector and safety reference.

Safety rules

Never batch-edit without a concrete --file.

Default to preview mode. Only use --write when the requested mutation is clear.

tag: selectors can match multiple headings. If a mutation selector is ambiguous, narrow it with line: or path:.

Export supports Typst only. If tinymist is missing, stop and report the install requirement instead of guessing.