> ## Documentation Index
> Fetch the complete documentation index at: https://docs.quanux.org/symphony/llms.txt
> Use this file to discover all available pages before exploring further.

# qxctl knowledge session: Authenticated Symphony Sessions

> Open, checkpoint, close, and recover authenticated Symphony coordinator sessions plus persistent SSFV maintenance streams with SSIAG-verified grants.

The `qxctl knowledge session ...` grammar opens noncanonical authenticated sessions through one exact bound coordinator and one TOPS-scoped SSIAG endpoint. A separate `session features ...` grammar drives the persistent SSFV maintenance stream.

## Base session grammar

```bash Session lifecycle theme={null}
qxctl knowledge session begin
qxctl knowledge session status
qxctl knowledge session checkpoint
qxctl knowledge session close
qxctl knowledge session recover
```

Every call requests a fresh exact grant and validates:

* Subject and target identity
* Policy and configuration state
* Expiry
* Caller-class neutrality
* Non-transferability
* Canonical-apply disablement
* Capability binding

Session evidence authorizes only the named protected noncanonical operation. Keep session and reconciliation journals separate; use context references only to associate them.

## SSFV maintenance stream

```bash Features stream theme={null}
qxctl knowledge session features begin
qxctl knowledge session features status
qxctl knowledge session features checkpoint
qxctl knowledge session features close
qxctl knowledge session features recover
```

The features stream is a separate persistent SSFV maintenance context. Mutations require:

* An open authenticated base session
* Exact coordinator and SSFV bindings
* Stable operation identifiers
* Exact compare-and-swap
* Fresh SSIAG evidence

<Note>
  Preserve the baseline snapshot and its original engine identity across compatible upgrades or rollbacks. Optional Maestro evidence must be a complete authenticated inventory; when Maestro is intentionally absent, record the explicit not-configured reason. `review_required` is evidence for caller review, not ratification.
</Note>

## Related surfaces

<CardGroup cols={2}>
  <Card title="SSIAG" icon="shield-halved" href="/symphony/symphony/governance/ssiag">
    Issues the fresh grants each session request validates.
  </Card>

  <Card title="Session coordinator" icon="gears" href="/symphony/symphony/engines/coordinator">
    The engine backing session and features journals.
  </Card>

  <Card title="qxctl reconcile" icon="arrows-rotate" href="/symphony/symphony/qxctl/reconcile">
    Reconciliation contexts that pair with sessions.
  </Card>

  <Card title="SSFV" icon="list-check" href="/symphony/symphony/skv/ssfv">
    The feature vector the features stream maintains.
  </Card>
</CardGroup>


## Related topics

- [Knowledge Session Coordinator for Symphony Vector Engines](/symphony/symphony/engines/coordinator.md)
- [qxctl knowledge reconcile: Worktree Reconciliation](/symphony/symphony/qxctl/reconcile.md)
- [qxctl knowledge: Cross-Vector Lifecycle Administration](/symphony/symphony/qxctl/knowledge.md)
- [qxctl: Symphony Agentic Administrative Command Line](/symphony/symphony/qxctl/overview.md)
- [qxctl maestro: Read Symphony Receptor Presence Inventory](/symphony/symphony/qxctl/maestro.md)