Skip to content

Session Bundle ​

Package wake-up context for the current session. This command turns Sibyl's hook-era startup context into a first-class CLI surface.

Usage ​

bash
sibyl session bundle
sibyl session bundle "archived entity paging"
sibyl session bundle --json

What It Includes ​

  • Current server and project context
  • Doing or blocked tasks for the current project
  • A few relevant decisions, plans, ideas, procedures, or other memories derived from the current task titles or your explicit query
  • One short "remember next" line

Project Scope ​

The bundle resolves its project the way sibyl context does: the directory link, then the active context's default project, then the legacy defaults.project setting. When none of those names a project and --all was not passed, the bundle reads nothing. It returns no tasks or memories, reports "scope": "none", and its "remember next" line asks you to link the directory. It never falls back to every project.

Options ​

OptionShortDefaultDescription
--task-limit-5Maximum active tasks to include
--memory-limit-3Maximum relevant memories to include
--all-afalseSearch across all projects
--json-jfalseOutput machine-readable bundle JSON

Examples ​

Wake up with current project context:

bash
sibyl session bundle

Focus the bundle on a specific topic:

bash
sibyl session bundle "backup job ids"

Use JSON from hooks or automation:

bash
sibyl session bundle --json | jq '.remember_next'

Search across all projects:

bash
sibyl session bundle --all

Released under the Apache-2.0 License.