aside-aside

name	aside-aside
description	Use this when you need to inspect or update Aside daemon settings, sessions, routine, task transcripts, child sessions, or session runtime config.
metadata	{"version":"0.1.0"}

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
}

aside.sessions.get(sessionId?): SessionSummary

Get one session. sessionId is optional only inside a real agent session.

aside.sessions.messages(sessionId?, options?): AgentMessage[]

Read transcript messages. Default: first 50 messages in ascending order. Use a small limit before printing.

const messages = aside.sessions.messages('session-id', { limit: 20, order: 'asc' });
console.log(messages.map(m => ({ role: m.role, content: m.content })).slice(-5));

aside.sessions.messageRows(sessionId?): { id, role, timestamp }[]

Read ordered message row IDs for exact transcript cutoffs or branch points.

aside.sessions.childSessions(parentId?, options?): SessionSummary[]

List child/subagent sessions. Pass { triggeredBy } to scope to one triggering tool call.

aside.sessions.update(sessionId, patch): SessionSummary

Update safe session metadata/config only: title, activeTabTargetId, model, permissionMode, permission, and runtimeConfig. Changing permissionMode also rewrites the concrete permission config used by runtime hooks.

aside.sessions.update('session-id', {
  runtimeConfig: { proactiveMode: true },
});

aside.sessions.archive(sessionId) / unarchive(sessionId)

Archive or restore a session. Do this only when the user asks.

aside.sessions.markRead(sessionId) / markUnread(sessionId)

Update task unread state.

Routines

Routine methods return saved routine definitions, including schedule, prompt, status cursor, and target session metadata. For update and delete, use routine_update tool. This skill provides read-only APIs.

aside.routines.list(options?): Routine[]

List non-deleted routines. Defaults to newest updated first, limit 20.

Useful options:

{
  agentId?: string;
  limit?: number; // max 200
}

aside.routines.get(id): Routine

Get one routine by id, including paused or deleted routines.