---
url: /sibyl/cli/session.md
---
# 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

| Option           | Short | Default | Description                          |
| ---------------- | ----- | ------- | ------------------------------------ |
| `--task-limit`   | -     | `5`     | Maximum active tasks to include      |
| `--memory-limit` | -     | `3`     | Maximum relevant memories to include |
| `--all`          | `-a`  | false   | Search across all projects           |
| `--json`         | `-j`  | false   | Output 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
```

## Related Commands

* [`sibyl context`](./context.md) - Recall a goal-scoped working context pack
* [`sibyl task list`](./task-list.md) - List active tasks directly