Oko CLI reference
Every public command, one exact contract.
These pages follow the current oko-cli dispatcher. Group commands and every public leaf have a stable, canonical route with the accepted invocation, inputs, state effects, and refusals.
agent
diff
proxy-sign
proxy-call
proxy-serve
proxy-translate
slack
oko-cli slackDispatches the slack command group.
Open command reference →oko-cli slack autoconfigureMaterializes Oko’s local Slack configuration from defaults and the operating store.
Open command reference →oko-cli slack postPosts a message through Oko’s exact Slack webhook or bot credential.
Open command reference →oko-cli slack statusReports local Slack configuration and live bot, discovery, and Socket Mode readiness.
Open command reference →pty
oko-cli ptyDispatches the pty command group.
Open command reference →oko-cli pty attachBridges the current terminal to a local PTY attach socket.
Open command reference →oko-cli pty relay-attachAttaches the current terminal as a viewer of a remotely relayed PTY session.
Open command reference →oko-cli pty relay-publishPublishes a local PTY attach socket to a remote relay session.
Open command reference →oko-cli pty broker-serveRuns the local PTY broker control server.
Open command reference →oko-cli pty broker-ensureEnsures a supervised PTY broker is available and responds to ping.
Open command reference →oko-cli pty broker-listLists PTY sessions owned by the local broker.
Open command reference →oko-cli pty broker-external-listDiscovers supported Claude Code and Codex processes outside Oko’s broker.
Open command reference →oko-cli pty broker-spawnStarts an executable in a new broker-owned PTY session.
Open command reference →oko-cli pty broker-adopt-externalResumes a discovered external Claude/Codex session inside an Oko broker PTY.
Open command reference →oko-cli pty broker-sendWrites exact text to a broker-owned PTY session.
Open command reference →oko-cli pty broker-repaintRequests a repaint of a broker-owned PTY session.
Open command reference →oko-cli pty broker-terminateTerminates a broker-owned PTY session.
Open command reference →auto-goals
oko-cli auto-goalsDispatches the auto-goals command group.
Open command reference →oko-cli auto-goals llm-evalEvaluates a routed LLM against the auto-goal intent JSONL corpus.
Open command reference →oko-cli auto-goals apple-evalEvaluates Apple’s local goal-intent classifier against a JSONL corpus.
Open command reference →oko-cli auto-goals silver-apple-evalEvaluates the Apple classifier against silver labels with resumable checkpoint state.
Open command reference →oko-cli auto-goals export-weekExports weekly ground-truth prompts as JSONL.
Open command reference →oko-cli auto-goals materialize-mappingsRepairs and materializes prompt mappings in stored auto-goal documents.
Open command reference →oko-cli auto-goals classify-missingBuilds a read-only candidate projection for today’s unclassified turns.
Open command reference →oko-cli auto-goals rebuild-windowStages a rebuilt auto-goal projection for a bounded date window.
Open command reference →oko-cli auto-goals reconcile-todayApplies transcript-proven goal completions once at the predicted end of day.
Open command reference →oko-cli auto-goals truthPrints the transcript-truth oracle’s completed/open goal view.
Open command reference →oko-cli auto-goals review-recomputeRecords explicit duplicate decisions in a new reviewed recompute artifact.
Open command reference →oko-cli auto-goals apply-recomputeApplies a reviewed auto-goal recompute artifact to the canonical store.
Open command reference →oko-cli auto-goals rollback-recomputeRolls back an applied auto-goal recompute artifact.
Open command reference →goals
oko-cli goalsDispatches the goals command group.
Open command reference →oko-cli goals extractRuns the local goal lifecycle model over Transcript Lake user turns.
Open command reference →oko-cli goals probeClassifies one fixed benign message to probe Apple’s local goal model.
Open command reference →oko-cli goals cleanShows the sanitized user turns that goal extraction would consume.
Open command reference →oko-cli goals tokensComputes model-free token, cost, and period insight summaries.
Open command reference →telemetry
oko-cli telemetryPrints recent working-hours telemetry from normalized transcript turns.
Open command reference →oko-cli telemetry forecastForecasts tomorrow’s working window from matching historical weekdays.
Open command reference →oko-cli telemetry calendar-pngRenders a member activity calendar to PNG.
Open command reference →oko-cli telemetry calendar-htmlRenders one or more interactive member activity calendars to HTML.
Open command reference →oko-cli telemetry calendar-debugPrints the exact turns and engaged-time segments behind one calendar day.
Open command reference →oko-cli telemetry provider-countsCounts transcript prompts by provider for each selected member and date range.
Open command reference →pricing
subscription-router
subscriptions
context
oko-cli contextDispatches the context command group.
Open command reference →oko-cli context snapshotExtracts a company-context snapshot through the configured Cognee bridge.
Open command reference →oko-cli context adviseGenerates a structured CEO/PM advisory from strategy and live GitHub execution data.
Open command reference →oko-cli context refresh-slackRefreshes Oko’s searchable local Slack context cache.
Open command reference →oko-cli context search-slackSearches Slack’s API, Oko’s local cache, or both and returns deduplicated results.
Open command reference →oko-cli context diagnose-goalsPrints the current goal-diagnostic context object used by Oko tools.
Open command reference →oko-cli context host-execExecutes a bounded host command and returns its structured context-tool result.
Open command reference →transcripts
suggestions
oko-cli suggestionsDispatches the suggestions command group.
Open command reference →oko-cli suggestions tickRuns one permanent responder tick, including replies and opt-in proactive Slack work.
Open command reference →oko-cli suggestions replyRuns only the targeted Slack reply portion of a suggestions tick.
Open command reference →oko-cli suggestions costsRefreshes the suggestions cost snapshot without scanning or posting to Slack.
Open command reference →oko-cli suggestions test-replyExercises reply classification/generation without a live Slack source thread.
Open command reference →oko-cli suggestions sync-strategyRefreshes the cached company strategy used by suggestions.
Open command reference →hooks
oko-cli hooksDispatches the hooks command group.
Open command reference →oko-cli hooks installMaterializes Oko’s supported hook bundle into local Claude/Codex hook settings.
Open command reference →oko-cli hooks publishPublishes Oko’s owned hook bundle for a team.
Open command reference →oko-cli hooks pullFetches the team hook bundle and materializes it locally.
Open command reference →oko-cli hooks syncAlias of hooks pull for fetching and materializing the team hook bundle.
Open command reference →autonomy
oko-cli autonomyDispatches the autonomy command group.
Open command reference →oko-cli autonomy enableEnables Oko’s bounded autonomous goal policy.
Open command reference →oko-cli autonomy disableDisables autonomous goal execution without deleting history.
Open command reference →oko-cli autonomy statusReports the current autonomy policy and recent run state.
Open command reference →oko-cli autonomy tickAttempts one bounded autonomous-goal execution under the saved policy.
Open command reference →calendar
oko-cli calendarDispatches the calendar command group.
Open command reference →oko-cli calendar connectConnects one of the user's own calendars: the macOS system calendars, Google Calendar, Microsoft 365, a CalDAV collection, or an ICS subscription.
Open command reference →oko-cli calendar accountsLists the connected calendar accounts without ever printing a secret.
Open command reference →oko-cli calendar disconnectRemoves a connected account and its locally synced events.
Open command reference →oko-cli calendar syncSyncs every connected account (or one) over a bounded window into the device-local events mirror.
Open command reference →oko-cli calendar listPrints the upcoming schedule from the device-local mirror.
Open command reference →oko-cli calendar statusReports connected accounts, the macOS consent verdict, and the store paths without prompting.
Open command reference →oko-cli calendar addCreates one event on a writable account: EventKit, Google, Microsoft, or CalDAV.
Open command reference →oko-cli calendar editChanges named fields of one existing event; untouched fields stay as the provider has them.
Open command reference →oko-cli calendar removeDeletes one event from a writable account and from the local mirror.
Open command reference →