Плагин oddyssey
CLI toolbox for Observability-Driven Development (ODD): coding agents observe local runs on an OpenTelemetry/Grafana stack - or remote ones on any OpenTelemetry backend - and feed the next spec-driven improvement loop.
Как установить плагин oddyssey
Выполните обе команды в Claude Code. Первая один раз добавляет маркетплейс; вторая устанавливает плагин.
/plugin marketplace add using-system/oddyssey
/plugin install oddyssey@oddyssey-pluginЧто внутри oddyssey
23 части прочитано из файлов самого плагина.
Команды 7
Запуск как /oddyssey:name- /oddyssey:odd-configswitch to <stack> (local | grafana | datadog | dynatrace | azure-monitor | cloud
Display the current oddyssey backend configuration - configured stack and environment, targeted instance, connection proof - then offer to change it: pick a backend from the full list, built-in or custom, and route the switch to the backend-configuration skill's Switch; targets a deployment environm
- /oddyssey:odd-instrument-bench<service> [smoke | load | stress | soak | spike | breakpoint] [against <URL>] [t
Investigate a service and author a k6 load-test benchmark plan as code in .odd/benchmarks/ - asks back whatever only a human can decide before dispatching the authoring agent, which validates the script with k6 inspect and one smoke iteration and never runs the benchmark
- /oddyssey:odd-instrument-otel[path or repo] [export stack] [context]
Investigate a codebase and get every input needed to plan OpenTelemetry instrumentation for it
- /oddyssey:odd-instrument-stackcreate a stack <name> [from <URL or path>] [: <instructions>] | for stack <name>
Author a custom observability stack as a directory in .odd/observability-stacks/ - guide.md plus the query scripts it names, verified live against the backend - through the stack-instrumentation-expert agent; also completes one from an instruction, links one another repository carries, and fixes one
- /oddyssey:odd-observe<service(s)> [on <stack>] [in <environment>] [drive | observe | post-hoc] [run <
Observe a running service through its telemetry (local stack or remote backend) and get the plan-ready observation report
- /oddyssey:odd-status[full] [<service | stack | env>] [wontfix <finding>: <why>] [<entry> is runtime
Where is the ODD loop? Read the repository's .odd/ history and render it as a one-screen synthesis - the loop state per lineage, its burn-down, the next recommended action - or, on request, the full tables (per-service loop state, findings ledger, trends, open telemetry gaps) - reports read-only, no
- /oddyssey:odd-verify[<report path> | my last <service | env | stack> report]
Verify that a fix or an implemented instrumentation plan landed - replay a stored report's protocol (observation or instrumentation report) and get the full observation report, carrying the verdict on everything it recorded - measurements, anomalies, telemetry gaps, or planned signals now present
Агенты 4
Вызов как @agent-oddyssey:name- @agent-oddyssey:k6-benchmark-expert.agent
Investigate a service and author a k6 load-test benchmark (script + manifest) as reviewed, committed code - validated with k6 inspect, a one-iteration smoke and a parse of the manifest before persisting, never executed as a benchmark. Input - the service to benchmark, and every authoring-inputs.md "
- @agent-oddyssey:observe-run.agent
Observe a running service through its telemetry (metrics, traces, logs, profiles) on any stack - the local oddyssey stack or a remote backend (Grafana, Datadog, Dynatrace, Azure Monitor, CloudWatch, a custom stack, ...) - and hand the main agent every input it needs to build a spec-driven plan of fi
- @agent-oddyssey:otel-instrumentation-expert.agent
Investigate a codebase or stack and hand the main agent every input it needs to build a complete spec-driven plan for implementing OpenTelemetry instrumentation. Input - the path (or repo) to investigate and, if known, the export stack. Recalls previous investigations from .odd/otel-instrumentation-
- @agent-oddyssey:stack-instrumentation-expert.agent
Author a custom observability stack for a backend the package does not ship, as a directory in .odd/observability-stacks/ - guide.md with the reference contract's sections, and scripts/ with the query scripts the guide names - every invocation verified live against the backend before it is written a
Skills 9
Claude загружает это при соответствии задачи- backend-configuration
Own the configured observability backend, in two sections invoked by name. Check: display the configured stack and the instance the runs will hit, prove the CLI connected, guide the user when it is not, and hand the preflight over to the mission. Switch: verify the target backend's CLI is installed (offer a guided install when missing), persist the switch via odd_config_set, persist the per-stack stack_config values the missions will need, then run Check for the proof. Stack-agnostic - the stack list and everything about a given stack come from the observability-cli-guides skill. Use before dispatching an observe, verify or bench mission, when the configured stack must be confirmed or the CLI's connection proven, when the user needs guidance to set their CLI up, and when the user asks to change the configured backend or to persist targeting values. Never installs silently, never authenticates on the user's behalf, never stores or echoes a secret.
- get-status
Render the state of the ODD loop from the repository's committed .odd/ history and git alone - one screen by default (the loop state per lineage with its burn-down and next action), the full tables on request (per-service loop state, findings ledger, trends, open telemetry gaps) - read-only, no backend queries, no report written. Use when answering where the loop is, when /odd-status runs, or when a status must be computed offline from the clone.
- k6-guides
Curated map of the official k6 load-testing docs - installation, running a script, scripting (checks/thresholds/scenarios), test types, protocols, and which questions a benchmark's inputs require before it can be authored. Use when authoring or reasoning about a k6 benchmark - pick the topic, open its reference file, and follow the linked official docs. Read by /odd-instrument-bench (which questions to ask), k6-benchmark-expert (authoring and validating), a stored benchmark's replay (running one), and the /odd-instrument-bench, /odd-observe, and /odd-verify preflights (ensuring k6 is present).
- observability-cli-guides
The package's knowledge of every observability stack it supports, one reference file per stack - the terminal query surface (how to authenticate and query metrics, traces, logs, and profiles from the CLI), how the stack's configuration is displayed and proven, and what its stack_config persists - plus the list of built-in stacks. Use when observing a run, local or remote, and when backend-configuration's Check or Switch need anything about a stack - Grafana (gcx), Datadog (Pup CLI), Dynatrace (dtctl and DQL), Azure Monitor (az), AWS CloudWatch and X-Ray (aws), and the local stack.
- odd-memory
The .odd/ memory - its contract and one reference per kind. The contract states what every kind shares (where the memory lives, the frontmatter and the whole body, append-only reports versus living-source benchmarks, recall by frontmatter then by section, the no-secrets rule, the work branch and the lone commit, the reply that carries a synthesis and never the artifact); each reference says how to persist, recall and show its kind - observation reports, instrumentation reports, benchmarks, the maintainer-ruling ledgers (finding decisions, tree-entry classifications), custom stacks. Read when a report, a benchmark, a custom stack or a decision is persisted, recalled, shown or inventoried, or when a finding is declined (wontfix) or such a decision reversed, or a tree entry is ruled runtime or non-runtime; never invoked on its own.
- otel-guides
Curated map of the official OpenTelemetry documentation by language. Use when planning or implementing OpenTelemetry instrumentation for a codebase - pick the language, open its reference file, and follow the linked official docs for traces, metrics, logs, instrumentation libraries, exporters, and SDK configuration. Covers C++, .NET, Erlang/Elixir, Go, Java, JavaScript, Kotlin, PHP, Python, Ruby, Rust, Swift, and other community SDKs, plus the cross-language references for SDK configuration, semantic conventions, generative AI (the gen_ai conventions and the instrumentation library per LLM SDK or agent framework), the Collector, and profiling.
- package-layout
Where this package is installed and what each part of it is - every skill, its reference files, its scripts, and the sibling directories the install carries. Use when a mission block needs the skills' directory, when a contract must name a reference or a script by path, or when anything is about to look for the package on disk. The answer comes from the script's own location, so it is exact wherever a host installed the package, and nothing has to be searched for or written down in advance.
- run-scenario
Drive a reproducible request scenario against a locally running service - ad-hoc requests, or a stored k6 benchmark from .odd/benchmarks/ - and record it verbatim, so the telemetry it produces can be compared with a later run. Use when traffic must be generated before observing a service, when a stored k6 benchmark must be run, when an observation report needs a replayable scenario, or when verifying after a fix that the same scenario now measures better.
- setup-local-stack
Configure gcx against the local oddyssey Grafana stack and query its four signals (metrics, traces, logs, profiles) without touching the user's own gcx contexts. Owns the global configuration's "local" stack value. Use when the configured stack is "local", when querying the local stack (Grafana host port from the global configuration, default 3000), when configuring gcx locally, when a command needs the Tempo, Prometheus, Loki, or Pyroscope datasource UID. gcx is the mandatory query CLI for the stack - install it if missing (brew install gcx, or the official install script from github.com/grafana/gcx).
Хуки 2
Запускается при этих событиях- PostToolUsecommand
В файле нет описания.
- PreToolUsecommand
В файле нет описания.
MCP servers 1
Запускается вместе с плагином- oddysseystdio
uvx --refresh-package oddyssey-mcp oddyssey-mcp==1.13.3
Использование oddyssey в Claude Code
Введите команду в сессии Claude Code:
/oddyssey:odd-config switch to <stack> (local | grafana | datadog | dynatrace | azure-monitor | cloud
/oddyssey:odd-instrument-bench <service> [smoke | load | stress | soak | spike | breakpoint] [against <URL>] [t
/oddyssey:odd-instrument-otel [path or repo] [export stack] [context]Запросите агента по имени:
@agent-oddyssey:k6-benchmark-expert.agent
@agent-oddyssey:observe-run.agentSkills не требуют команд. Claude считывает их, когда ваш запрос соответствует их описанию.
Обновить, выключить или удалить
- Обновить плагин (shell)
- claude plugin update oddyssey@oddyssey-plugin
- Обновить marketplace
- /plugin marketplace update oddyssey-plugin
- Временно выключить
- /plugin disable oddyssey@oddyssey-plugin
- Удалить
- /plugin uninstall oddyssey@oddyssey-plugin
Навыки в oddyssey
- backend-configurationusing-system/oddyssey
Own the configured observability backend, in two sections invoked by name. Check: display the configured stack and the instance the runs will hit, prove the CLI connected, guide the user when it is not, and hand the preflight over to the mission. Switch: verify the target backend's CLI is installed (offer a guided install when missing), persist the switch via odd_config_set, persist the per-stack stack_config values the missions will need, then run Check for the proof. Stack-agnostic - the stack list and everything about a given stack come from the observability-cli-guides skill. Use before dispatching an observe, verify or bench mission, when the configured stack must be confirmed or the CLI's connection proven, when the user needs guidance to set their CLI up, and when the user asks to change the configured backend or to persist targeting values. Never installs silently, never authenticates on the user's behalf, never stores or echoes a secret.
2 файла10звёзд - get-statususing-system/oddyssey
Render the state of the ODD loop from the repository's committed .odd/ history and git alone - one screen by default (the loop state per lineage with its burn-down and next action), the full tables on request (per-service loop state, findings ledger, trends, open telemetry gaps) - read-only, no backend queries, no report written. Use when answering where the loop is, when /odd-status runs, or when a status must be computed offline from the clone.
3 файла10звёзд - k6-guidesusing-system/oddyssey
Curated map of the official k6 load-testing docs - installation, running a script, scripting (checks/thresholds/scenarios), test types, protocols, and which questions a benchmark's inputs require before it can be authored. Use when authoring or reasoning about a k6 benchmark - pick the topic, open its reference file, and follow the linked official docs. Read by /odd-instrument-bench (which questions to ask), k6-benchmark-expert (authoring and validating), a stored benchmark's replay (running one), and the /odd-instrument-bench, /odd-observe, and /odd-verify preflights (ensuring k6 is present).
10 файлов10звёзд - observability-cli-guidesusing-system/oddyssey
The package's knowledge of every observability stack it supports, one reference file per stack - the terminal query surface (how to authenticate and query metrics, traces, logs, and profiles from the CLI), how the stack's configuration is displayed and proven, and what its stack_config persists - plus the list of built-in stacks. Use when observing a run, local or remote, and when backend-configuration's Check or Switch need anything about a stack - Grafana (gcx), Datadog (Pup CLI), Dynatrace (dtctl and DQL), Azure Monitor (az), AWS CloudWatch and X-Ray (aws), and the local stack.
29 файлов10звёзд - odd-memoryusing-system/oddyssey
The .odd/ memory - its contract and one reference per kind. The contract states what every kind shares (where the memory lives, the frontmatter and the whole body, append-only reports versus living-source benchmarks, recall by frontmatter then by section, the no-secrets rule, the work branch and the lone commit, the reply that carries a synthesis and never the artifact); each reference says how to persist, recall and show its kind - observation reports, instrumentation reports, benchmarks, the maintainer-ruling ledgers (finding decisions, tree-entry classifications), custom stacks. Read when a report, a benchmark, a custom stack or a decision is persisted, recalled, shown or inventoried, or when a finding is declined (wontfix) or such a decision reversed, or a tree entry is ruled runtime or non-runtime; never invoked on its own.
9 файлов10звёзд - otel-guidesusing-system/oddyssey
Curated map of the official OpenTelemetry documentation by language. Use when planning or implementing OpenTelemetry instrumentation for a codebase - pick the language, open its reference file, and follow the linked official docs for traces, metrics, logs, instrumentation libraries, exporters, and SDK configuration. Covers C++, .NET, Erlang/Elixir, Go, Java, JavaScript, Kotlin, PHP, Python, Ruby, Rust, Swift, and other community SDKs, plus the cross-language references for SDK configuration, semantic conventions, generative AI (the gen_ai conventions and the instrumentation library per LLM SDK or agent framework), the Collector, and profiling.
19 файлов10звёзд - package-layoutusing-system/oddyssey
Where this package is installed and what each part of it is - every skill, its reference files, its scripts, and the sibling directories the install carries. Use when a mission block needs the skills' directory, when a contract must name a reference or a script by path, or when anything is about to look for the package on disk. The answer comes from the script's own location, so it is exact wherever a host installed the package, and nothing has to be searched for or written down in advance.
2 файла10звёзд - run-scenariousing-system/oddyssey
Drive a reproducible request scenario against a locally running service - ad-hoc requests, or a stored k6 benchmark from .odd/benchmarks/ - and record it verbatim, so the telemetry it produces can be compared with a later run. Use when traffic must be generated before observing a service, when a stored k6 benchmark must be run, when an observation report needs a replayable scenario, or when verifying after a fix that the same scenario now measures better.
5 файлов10звёзд - setup-local-stackusing-system/oddyssey
Configure gcx against the local oddyssey Grafana stack and query its four signals (metrics, traces, logs, profiles) without touching the user's own gcx contexts. Owns the global configuration's "local" stack value. Use when the configured stack is "local", when querying the local stack (Grafana host port from the global configuration, default 3000), when configuring gcx locally, when a command needs the Tempo, Prometheus, Loki, or Pyroscope datasource UID. gcx is the mandatory query CLI for the stack - install it if missing (brew install gcx, or the official install script from github.com/grafana/gcx).
4 файла10звёзд
Вопросы о плагине oddyssey
Как установить плагин oddyssey?
В Claude Code выполните /plugin marketplace add using-system/oddyssey, затем /plugin install oddyssey@oddyssey-plugin.
Что включает плагин oddyssey?
oddyssey объединяет 7 команд, 4 агента, 9 навыков, хуки, MCP server.
Какие команды добавляет плагин oddyssey?
Он добавляет /oddyssey:odd-config, /oddyssey:odd-instrument-bench, /oddyssey:odd-instrument-otel, /oddyssey:odd-instrument-stack, /oddyssey:odd-observe, /oddyssey:odd-status +1. Запускайте их в Claude Code с префиксом плагина, например /oddyssey:odd-config.
Какие агенты идут в комплекте с oddyssey?
k6-benchmark-expert.agent, observe-run.agent, otel-instrumentation-expert.agent, stack-instrumentation-expert.agent. Вызовите одного из них через @agent-oddyssey:k6-benchmark-expert.agent.
Как обновить или удалить плагин oddyssey?
Обновите его с помощью claude plugin update oddyssey@oddyssey-plugin в вашем shell или на вкладке Installed в /plugin. Удалите его с помощью /plugin uninstall oddyssey@oddyssey-plugin.
Под какой лицензией распространяется плагин oddyssey?
MIT, как указано в манифесте плагина.