Agent WorkflowsA field guide by Doruk
CLI & agent plugin

Session Marking

Bind an agent session to an explicit project and task.

doruksahin/session-marking
01 / Input

The current or explicit session identity, a project and task target, and any optional destination configuration.

Session Marking

CLI & agent plugin
02 / Output

An immutable local binding by default. Enabled host integrations can also publish their own destination records.

When to reach for it

Use it when the current Codex or Claude Code session should be associated with a known work item.

How it works

Local storage preserves the first binding and rejects a different target for that session. Optional integrations validate and record the target for their own destination.

Trace this to the source ↗
Where its responsibility ends

Local use needs no host integration. Destinations own separate records and are not synchronized. There is no prompt-submit hook that automatically marks future sessions.

Setup & first use

Follow global CLI installation, then the first-session guide. Native plugin installation is optional for command-line use.

Open the owner’s instructions ↗
Exact files & reviewed version

This explanation follows the recorded source snapshot reviewed on 17 September 2026.

b63c5978a669cb5c3a2cbf84447f904e7662f938

Public repository.