aside-aside

Aside

Use the aside global in the REPL tool to inspect account settings and session/task state. Prefer reads first. Only call write methods when the user asks for a settings/session change or the task clearly requires it.

Quick Reference

const allSettings = aside.settings.getAll();
const memory = aside.settings.get('memory');
aside.settings.set('memory', { ...memory, enabled: true });

const recent = aside.sessions.list({ limit: 10 });
const current = aside.sessions.current();
const session = aside.sessions.get('session-id');
const messages = aside.sessions.messages('session-id', { limit: 40, order: 'asc' });
const rows = aside.sessions.messageRows('session-id');
const children = aside.sessions.childSessions('session-id');

const routines = aside.routines.list({ limit: 10 });
const routine = aside.routines.get('routine-id');

Settings

aside.settings.getAll(): SettingsData

Returns account-scoped daemon settings from settings.json.

aside.settings.get(key): SettingsData[key]

Read one setting key such as defaultModel, modelCategories, followUpBehavior, selectionOverlay, memory, compaction, or retry.

aside.settings.set(key, value): SettingsData

Replace one setting key after schema validation. Always read the existing value first and preserve unrelated fields.

const current = aside.settings.get('compaction');
aside.settings.set('compaction', { ...current, enabled: false });

Sessions

Session methods return concise metadata and omit bulky fields like systemPrompt, toolState, and queued message bodies.

aside.sessions.current(): SessionSummary | undefined

Returns the current agent session when the REPL is running inside one.

aside.sessions.list(options?): SessionSummary[]

List sessions. Defaults to visible, non-archived, root sessions, newest first, limit 20.

Useful options:

{
  agentId?: string;
  order?: 'desc' | 'asc';
  cursor?: number;
  limit?: number; // max 200
}