- `--store <path>`: explicit store path (cannot be combined with `--agent` or `--all-agents`)

- `--limit <n|all>`: max rows to output (default `100`; `all` restores full output)

Tail human-readable trajectory progress for stored sessions:

```bash

openclaw sessions tail

openclaw sessions tail --follow

openclaw sessions tail --session-key "agent:main:telegram:direct:123" --tail 25

openclaw sessions --agent work tail --follow

openclaw sessions --all-agents tail --follow

```

`openclaw sessions tail` renders recent trajectory JSONL events as compact progress lines. Without `--session-key`, it tails running sessions first, then the latest stored session. `--tail <count>` controls how many existing events print before follow mode; the default is `80`, and `0` starts at the current end. `--follow` keeps watching the selected trajectory files, including relocated files referenced by `<session>.trajectory-path.json`.

The progress view is intentionally conservative: prompt text, tool arguments, and tool result bodies are not printed. Tool calls show the tool name with `{...redacted...}`; tool results show status such as `ok`, `error`, or `done`; model completion lines show provider/model and terminal status.

Export a trajectory bundle for a stored session:

```bash

healthCommand: vi.fn(),

sessionsCommand: vi.fn(),

sessionsCleanupCommand: vi.fn(),

sessionsTailCommand: vi.fn(),

exportTrajectoryCommand: vi.fn(),

commitmentsListCommand: vi.fn(),

commitmentsDismissCommand: vi.fn(),

const healthCommand = mocks.healthCommand;

const sessionsCommand = mocks.sessionsCommand;

const sessionsCleanupCommand = mocks.sessionsCleanupCommand;

const sessionsTailCommand = mocks.sessionsTailCommand;

const exportTrajectoryCommand = mocks.exportTrajectoryCommand;

const commitmentsListCommand = mocks.commitmentsListCommand;

const commitmentsDismissCommand = mocks.commitmentsDismissCommand;

sessionsCleanupCommand: mocks.sessionsCleanupCommand,

}));

vi.mock("../../commands/sessions-tail.js", () => ({

sessionsTailCommand: mocks.sessionsTailCommand,

}));

vi.mock("../../commands/export-trajectory.js", () => ({

exportTrajectoryCommand: mocks.exportTrajectoryCommand,

}));

healthCommand.mockResolvedValue(undefined);

sessionsCommand.mockResolvedValue(undefined);

sessionsCleanupCommand.mockResolvedValue(undefined);

sessionsTailCommand.mockResolvedValue(undefined);

exportTrajectoryCommand.mockResolvedValue(undefined);

commitmentsListCommand.mockResolvedValue(undefined);

commitmentsDismissCommand.mockResolvedValue(undefined);

});

});

it("runs sessions tail with forwarded progress options", async () => {

await runCli([

"sessions",

"--store",

"/tmp/sessions.json",

"--agent",

"work",

"tail",

"--session-key",

"agent:main:telegram:direct:owner",

"--tail",

"5",

"--follow",

]);

expectCommandOptions(sessionsTailCommand, {

sessionKey: "agent:main:telegram:direct:owner",

store: "/tmp/sessions.json",

agent: "work",

allAgents: false,

follow: true,

tail: "5",

});

});

it("runs sessions export-trajectory with owner-routable export options", async () => {

await runCli([

"sessions",

});

});

sessionsCmd

.command("tail")

.description("Tail human-readable session trajectory progress")

.option("--session-key <key>", "Session key to tail (default: active sessions or latest)")

.option("--tail <count>", "Number of existing trajectory events to show", "80")

.option("--follow", "Continue following for new trajectory events", false)

.option("--store <path>", "Path to session store (default: resolved from config)")

.option("--agent <id>", "Agent id to inspect (default: configured default agent)")

.option("--all-agents", "Aggregate sessions across all configured agents", false)

.action(async (opts, command) => {

const parentOpts = command.parent?.opts() as

| {

store?: string;

agent?: string;

allAgents?: boolean;

}

| undefined;

await runCommandWithRuntime(defaultRuntime, async () => {

const { sessionsTailCommand } = await import("../../commands/sessions-tail.js");

await sessionsTailCommand(

{

sessionKey: opts.sessionKey as string | undefined,

store: (opts.store as string | undefined) ?? parentOpts?.store,

agent: (opts.agent as string | undefined) ?? parentOpts?.agent,

allAgents: Boolean(opts.allAgents || parentOpts?.allAgents),

follow: Boolean(opts.follow),

tail: opts.tail as string | undefined,

},

defaultRuntime,

);

});

});

sessionsCmd

.command("export-trajectory")

.description("Export a redacted trajectory bundle for a stored session")