docs: give session tags a how-to of their own #484

Merged

natsukium merged 1 commit from docs/label-sessions-howto into main 2026-09-26 12:20:27 +09:00

Conversation 0 Commits 1 Files changed 5 +84 -25

natsukium commented 2026-09-26 11:10:36 +09:00

Owner

Copy link

New how-to docs/how-to/label-sessions-with-tags.md. It opens with when a tag helps (several agents at once, one project's sessions, a job's state), then: tag at spawn, add/remove (one call, applied whole), list by tag, pick with fzf and attach, end every session with a tag.

• reap-sessions.md loses its tag section (whose recipe attached rather than reaped) and links to the new page for reaping by tag.
• tmux-workflows-without-tmux.md "Session names", docs/README.md and the drive-without-a-window tutorial point at the new page.
• Every flag and limit is from reference/cli.md and crates/felis-cli/src/cli_sessions.rs (--tag and --remove are repeatable; 32 tags of 128 bytes; an over-cap call is refused whole). No broadcast/send fan-out example, since the shipped skill states tags are picker labels, not groups.

New how-to `docs/how-to/label-sessions-with-tags.md`. It opens with when a tag helps (several agents at once, one project's sessions, a job's state), then: tag at spawn, add/remove (one call, applied whole), list by tag, pick with fzf and attach, end every session with a tag. - `reap-sessions.md` loses its tag section (whose recipe attached rather than reaped) and links to the new page for reaping by tag. - `tmux-workflows-without-tmux.md` "Session names", `docs/README.md` and the `drive-without-a-window` tutorial point at the new page. - Every flag and limit is from `reference/cli.md` and `crates/felis-cli/src/cli_sessions.rs` (`--tag` and `--remove` are repeatable; 32 tags of 128 bytes; an over-cap call is refused whole). No broadcast/`send` fan-out example, since the shipped skill states tags are picker labels, not groups.

natsukium added 1 commit 2026-09-26 11:10:36 +09:00

docs: give session tags a how-to of their own ... 3cb7aedd02

Tagging lived as a section of the reap-sessions guide, although its
recipe tagged sessions and attached to one through fzf; nothing in it
reaped. A reader looking for session names (the tmux-workflows table
sends them there) had to find labeling inside a page about deleting.
The new guide opens with the situations a tag is for (parallel agents,
one project's sessions, a job's state) and then walks spawn --tag,
adding and removing, listing, picking, and ending a tagged group.

Assisted-by: Claude Code

natsukium scheduled this pull request to auto merge when all checks succeed 2026-09-26 12:19:48 +09:00

natsukium merged commit a1f1a83950 into main 2026-09-26 12:20:27 +09:00

natsukium deleted branch docs/label-sessions-howto 2026-09-26 12:20:27 +09:00

natsukium referenced this pull request from a commit 2026-09-26 12:20:28 +09:00

docs: give session tags a how-to of their own (#484)

Commenting is not possible because the repository is archived.

Reviewers

No reviewers

Labels

Clear labels   

priority/P0

Must be resolved before the v0.1.0 tag

  

priority/P1

Must be settled before the first public contract freezes

  

priority/P2

Explicitly deferred until after v0.1.0

  

release/v0.1.0

Work tracked for the first tagged release

  

status/blocked

Cannot start now: waits on an upstream release, another issue, or a recorded revisit trigger

  

status/planned

Triaged with a source-grounded plan and a passed pi review; ready to implement

  

type/bug

Shipped behavior that contradicts the docs or the code's own intent; needs a product code change

  

type/design

An open scope or trade-off question; needs a recorded decision in the owning explanation doc before code

  

type/test-gap

Documented or reviewed behavior that no test pins; usually split from a review finding, needs no product code change

  

type/tracker

Parent issue that tracks child work

No labels

priority/P0

priority/P1

priority/P2

release/v0.1.0

status/blocked

status/planned

type/bug

type/design

type/test-gap

type/tracker

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

natsukium/felis!484

No description provided.