| name | cortex-logs |
| description | Tail or follow cortex service logs from Docker Compose. Use when the user asks for cortex service logs, startup logs, crash logs, plugin deployment logs, Docker logs, or follow mode. This is for the service's stdout/stderr, not client syslog entries. |
Cortex Service Logs
Show recent cortex service logs. These are the binary's stdout/stderr, not syslog entries received from clients. Use the cortex MCP tool with action=tail for received log entries.
Workflow
-
Check server mode:
echo "$CLAUDE_PLUGIN_OPTION_IS_SERVER"
If false, explain that the local plugin is in client mode and has no local service logs to tail.
-
Parse user arguments:
- empty: last 50 lines, no follow
- bare integer such as
100: that many lines, no follow
--follow or -f: last 50 lines, then stream
- integer plus follow flag: that many lines, then stream
-
Run Docker Compose logs:
CORTEX_HOME="${CORTEX_HOME:-$HOME/.cortex}"
docker compose --env-file "${CORTEX_HOME}/.env" -f "${CORTEX_HOME}/compose/docker-compose.yml" logs cortex --tail <N> --no-color
For follow mode, add -f and omit --no-color.
If the plugin compose project has no container, report that Docker mode is
configured but no plugin-managed container is running. Do not guess a source
checkout path.
Output
Show the captured logs directly. If follow mode is active, the streaming output is the deliverable until the user interrupts.
If the logs show obvious unhealthy patterns such as repeated restarts, panics, bind errors, or DB lock errors, summarize the pattern after the log excerpt and suggest cortex-dr for full diagnostics.