---
name: sol
version: 1.0.0
description: >
  Read-only query of your journal (solstone) from any project, plus routing
  guidance for app-specific `sol call <app>` commands. Look up people and
  relationships, today's events; read transcripts. TRIGGER: solstone, sol, my
  journal, search my memory, what happened, who is, meeting with,
  recall, sol call routing, sol call journal/entities/transcripts.
---

# sol — journal query router

Read-only query interface to your journal. Invoke via Bash:
`sol call <app> <verb> [flags]`.

Use this skill to search memories, look up people, check today's events, read
transcripts, and choose the right `sol call` app command from outside the
solstone project context.

## Prerequisites

The `sol` CLI must be on PATH. Quick check:

```bash
sol help
```

If this fails, solstone is not installed. Install it from the solstone project:
`journal setup`.

## Capabilities

### recall — search your memory

Search the journal index for anything matching a query.

```bash
sol call journal search "<query>"
sol call journal search "<query>" --day 20260327
sol call journal search "<query>" --facet work
sol call journal search "<query>" --day-from 20260320 --day-to 20260327
```

Dates use `YYYYMMDD` format. Omit `--day` to search all days. Omit `--facet` to
search all facets.

### who — entities

Look up what the journal knows about a person, company, or project.

```bash
sol call entities search --query "<query>"
sol call entities observations "<entity_name>" --facet "<facet>"
sol call entities network "<entity_name>" --limit 10
sol call entities history "<entity_name>"
```

### today — what's happening now

Combine these commands to get a picture of the current day:

```bash
sol call activities list --source anticipated
sol call journal news "<facet>"
```

### transcript — meeting transcripts

Read what was said during meetings or any recorded time.

```bash
sol call transcripts scan
sol call transcripts scan 20260327
sol call transcripts read
sol call transcripts read 20260327 --start 140000 --length 120
sol call transcripts stats
```

`scan` first to see what's available, then `read` with `--start` (HHMMSS,
24-hour format) and `--length` (minutes) to narrow down.

### status — system health

Check if solstone is running and how much data exists.

```bash
sol call journal storage-summary
sol call support diagnose
```

## Per-app command map

See [Commands](references/commands.md) for the generated inventory of every
`sol call <app>` command contributed by app skill fragments, including triggers
and read/write/other polarity. Regenerate it with `sol skills build` or
`make skills`; do not inline those command tables here.

## Paths

`sol root` prints the solstone repo root, useful for scripting:
`cd $(sol root)`.

## Environment

The `sol` CLI uses three environment variables that default sensibly:

- `SOL_DAY` — defaults to today (`YYYYMMDD`)
- `SOL_FACET` — defaults to all facets
- `SOL_SEGMENT` — defaults to no segment

External callers should not need to set these. Use explicit flags (`--day`,
`--facet`) when narrowing scope is needed.

## Composing queries

**"Brief me on today"** — events plus active relationships:

```bash
sol call activities list --source anticipated
sol call entities search --limit 5
```

**"Prep me for a meeting with X"** — recent transcript mentions:

```bash
sol call journal search "<name>" --day-from 20260320
```

**"What did I miss yesterday?"** — yesterday's events, transcripts, and news:

```bash
sol call journal search "" -d 20260326 -a meetings
sol call transcripts scan 20260326
sol call journal news "<facet>" --day 20260326
```

## Output format

Most commands output plain text by default. Many support `--json` for structured
output. Prefer plain text for human-readable answers; use `--json` when you need
to process the data further.

## What you cannot do

This is a read-only interface. The journal is the person's private space. You
cannot:

- Create, delete, or modify facets
- Attach or modify entities
- Write news or observations
- Run pipeline operations (think, indexer, transcribe)
- Access internal agent state or orchestration

If a task requires writing to the journal, it must be done from within the
solstone project context using sol's internal skills.

## Error handling

If `sol` is not found on PATH or returns an error:

- `"command not found: sol"` — solstone is not installed. The user needs to run
  `journal setup` in their solstone project.
- `"journal not found"` or empty output — the journal directory doesn't exist or
  has no data yet. solstone may be installed but not initialized.
- Connection errors from `sol call support` — every support command needs the
  local solstone service reachable. Portal-backed commands (`search`, `article`)
  can additionally fail when the journal host is offline.

Do not retry failed commands. Report the error clearly so the user can
investigate.
