Memorix Sessions

memorix_session_start is optional. Use it when session semantics help; do not make memory-only work heavier than needed.

Tool Router

| Situation | Prefer | CLI fallback | |---|---|---| | Resume a prior long-running task | memorix_session_start | memorix session start --agent <name> | | HTTP control plane needs project binding | memorix_session_start with projectRoot | memorix session start --projectRoot <absolute-path> | | Need recent handoff/session summaries | memorix_session_context | memorix session context | | End a real working session | memorix_session_end | memorix session end --sessionId <id> --summary "<summary>" | | Need explicit subagent coordination identity | memorix_session_start with joinTeam: true | memorix session start --joinTeam --agentType <agent> |

Decision Rules

• For normal memory search/store, do not require session start.
• In HTTP mode, pass the absolute workspace path as projectRoot when available.
• projectRoot is a detection anchor; Git identity is the final project identity.
• Do not join coordination state unless the user is using tasks, messages, locks, handoff, or memorix orchestrate.