Config

asem init --interactive creates .asem.yaml in the Worktree Root.

Generated config

A minimal config records the Workspace and default Templates. Generated config omits empty schema-default fields and avoids JSON-like flow-style empty collections.

workspace:
  id: acme

defaults:
  agent: pi
  mux: tmux

Exact fields can grow as Templates and local defaults are configured.

Workspace and Worktree Root

Normal visibility and messaging use the Effective Scope: Workspace id plus Worktree Root. This keeps local Sessions from different checkouts separate even when they share a Workspace name.

Templates

Agent Templates define command sequences for AI clients. Multiplexer Templates define how a child Session is hosted and attached. Template command sequences are runtime configuration, not workflow definitions.

Runtime state

Token-bearing runtime files are ignored and should not be committed:

.asem/sessions/
.asem/current-session*.json
.asem/tokens/

Store only token hashes in SQLite. Avoid putting raw tokens in command-line arguments, pane labels, logs, or structured errors.

Integration Target config

asem mcp add --for and asem skills add --for update the selected external AI client's config or Skill directory. Those target files are separate from .asem.yaml.