mayros cortex
Check the status of the Cortex knowledge graph sidecar and manage its connection. Commands first attempt to reach Cortex through the Gateway RPC for richer information; if the Gateway is unavailable, they fall back to a direct connection.
Global options
| Flag | Description | Default |
|---|---|---|
--cortex-host <host> | Cortex host | 127.0.0.1 (or from config) |
--cortex-port <port> | Cortex port | 19090 (or from config) |
--cortex-token <token> | Cortex auth token (or set CORTEX_AUTH_TOKEN env var) | — |
These options are inherited by all subcommands and can also be set via the memory-semantic plugin configuration or environment variables (CORTEX_HOST, CORTEX_PORT, CORTEX_AUTH_TOKEN).
Subcommands
cortex status
Check Cortex sidecar status and connectivity.
When reached via Gateway RPC, shows extended information including sidecar state, auto-start configuration, and pending write count. When reached directly, shows health, version, uptime, and graph statistics.
Additional options:
| Flag | Description | Default |
|---|---|---|
--url <url> | Gateway WebSocket URL | — |
--token <token> | Gateway token (if required) | — |
--timeout <ms> | Timeout in ms | 30000 |
Output fields:
- Endpoint — the Cortex base URL
- Status — ONLINE or OFFLINE
- Sidecar — sidecar process state (via Gateway only)
- Auto-start — whether the sidecar starts automatically (via Gateway only)
- Version — Cortex server version
- Uptime — server uptime in seconds
- Triples — total triple count in the graph
- Subjects — total subject count in the graph
- Pending writes — queued write operations (via Gateway only)
cortex reconnect
Attempt to restart the Cortex sidecar through the Gateway. If the Gateway is unavailable, checks Cortex directly and reports whether it is reachable.
Additional options:
| Flag | Description | Default |
|---|---|---|
--url <url> | Gateway WebSocket URL | — |
--token <token> | Gateway token (if required) | — |
--timeout <ms> | Timeout in ms | 30000 |
Examples
bash# Check Cortex status mayros cortex status # Check status using a specific host and port mayros cortex --cortex-host 192.168.1.10 --cortex-port 19090 status # Reconnect the Cortex sidecar mayros cortex reconnect # Check status via a remote gateway mayros cortex status --url ws://remote:8080
Related
- Knowledge Graph — Cortex knowledge graph overview
- kg — query and manage the knowledge graph
- gateway — Gateway service management