avids2 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
projectRootwhen available. projectRootis 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.