| name | activities |
| description | Completed activity records organized by facet and day. List, inspect, create, update, mute/unmute activity spans, including synthetic records from the CLI. TRIGGER: activity, activities, work session, completed span, mute/unmute, activity record, meeting attendees, sol call activities list/create/update/mute/unmute/get.
|
Activities CLI Skill
Manage completed activity records. Invoke via Bash: sol call activities <command> [args...].
Environment defaults: When SOL_DAY is set, commands that take DAY use it automatically. Same for SOL_FACET where FACET is accepted.
Common pattern:
sol call activities <command> [args...]
list
sol call activities list [-d DAY | --from DAY --to DAY] [-f FACET] [-a ACTIVITY] [--entity ENTITY] [--source SOURCE] [--all] [--json]
List activity records for one day or an inclusive day range.
-d, --day: single day in YYYYMMDD (default: SOL_DAY env).
--from, --to: inclusive day range in YYYYMMDD.
-f, --facet: optional facet filter. Omit to include all facets.
-a, --activity: optional activity-type filter.
--entity: optional active-entity filter.
--source: optional record-source filter (anticipated, user, or cogitate). Omit to include all sources.
--all: include hidden activity records.
--json: emit raw JSON instead of formatted text.
Examples:
sol call activities list -d 20260115 -f work
sol call activities list --from 20260101 --to 20260107 -f work --activity coding
sol call activities list -d 20260115 --entity "Alicia Chen" --json
get
sol call activities get SPAN_ID [-f FACET] [-d DAY] [--json]
Fetch one activity record by id.
SPAN_ID: activity record id.
-f, --facet: facet name (default: SOL_FACET env).
-d, --day: day in YYYYMMDD (default: SOL_DAY env).
--json: emit the raw record.
Example:
sol call activities get coding_090000_300 -f work -d 20260115
create
sol call activities create [-f FACET] [-d DAY] [--since-segment SEGMENT] [--source user|cogitate] [--title T] [--activity TYPE] [--description D] [--details E] [--json]
Create a new activity record from argv flags or a JSON object on stdin.
-f, --facet: facet name (default: SOL_FACET env).
-d, --day: day in YYYYMMDD (default: SOL_DAY env).
--since-segment: optional segment key to anchor a real activity span.
--source: record source label (user by default).
--title: activity title. Required in argv mode.
--activity: activity type. Required in argv mode.
--description: optional one-line description.
--details: optional longer details.
--json: emit the created record.
Input styles:
- Use argv flags for simple records.
- Use stdin JSON when you need
participation.
Stdin JSON requirements:
- Required:
title, activity
- Optional:
description, details, participation
participation is available only via stdin JSON, not via flags. It is an array
of participant objects. Each entry must include:
name: non-empty string.
role: "attendee" or "mentioned".
source: one of "voice", "speaker_label", "transcript", "screen", "other".
confidence: number (typically 0.0-1.0).
context: string describing where the detection came from.
Names are resolved against journal entities after validation; any caller-supplied entity_id is ignored.
Examples:
sol call activities create -f work --title "Deep work" --activity coding
sol call activities create -f work --title "Session review" --activity coding --details "Retrospective notes" --since-segment 090000_300 --source cogitate --json
echo '{"title":"Deep work","activity":"coding"}' | sol call activities create -f work
echo '{"title":"Session review","activity":"coding","details":"Retrospective notes"}' | sol call activities create -f work --since-segment 090000_300 --source cogitate --json
echo '{
"title":"Sync with Alicia",
"activity":"meeting",
"participation":[
{"name":"Alicia Chen","role":"attendee","source":"voice","confidence":0.95,"context":"voice detected start of segment"},
{"name":"You","role":"attendee","source":"screen","confidence":1.0,"context":"screen share"}
]
}' | sol call activities create -f work
update
sol call activities update SPAN_ID [-f FACET] [-d DAY] [--note TEXT] [--title T] [--description D] [--details E] [--json]
Update one activity record from argv flags or a JSON patch on stdin.
SPAN_ID: activity record id.
-f, --facet: facet name (default: SOL_FACET env).
-d, --day: day in YYYYMMDD (default: SOL_DAY env).
--note: optional edit note stored in the record history.
--title: replacement title.
--description: replacement description.
--details: replacement details.
--json: emit the updated record.
Stdin JSON may include only title, description, and details.
Examples:
sol call activities update coding_090000_300 -f work --title "Focused coding" --details "Closed out CLI edge cases" --note "tightened summary"
echo '{"title":"Focused coding","details":"Closed out CLI edge cases"}' | sol call activities update coding_090000_300 -f work --note "tightened summary"
mute
sol call activities mute SPAN_ID [-f FACET] [-d DAY] [--reason TEXT] [--json]
Hide an activity record without deleting it.
SPAN_ID: activity record id.
-f, --facet: facet name (default: SOL_FACET env).
-d, --day: day in YYYYMMDD (default: SOL_DAY env).
--reason: optional note stored in the edit history.
--json: emit the updated record.
Example:
sol call activities mute coding_090000_300 -f work --reason "synthetic duplicate"
unmute
sol call activities unmute SPAN_ID [-f FACET] [-d DAY] [--reason TEXT] [--json]
Restore a muted activity record.
SPAN_ID: activity record id.
-f, --facet: facet name (default: SOL_FACET env).
-d, --day: day in YYYYMMDD (default: SOL_DAY env).
--reason: optional note stored in the edit history.
--json: emit the updated record.
Example:
sol call activities unmute coding_090000_300 -f work --reason "keep owner-authored record"