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-pluginoddyssey 구성 요소
플러그인 파일에서 읽어온 23개의 항목입니다.
Commands 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
Agents 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).
Hooks 2
다음 이벤트에서 실행됩니다- PostToolUsecommand
파일에 설명이 없습니다.
- PreToolUsecommand
파일에 설명이 없습니다.
MCP server 1
플러그인과 함께 시작됩니다- oddysseystdio
uvx --refresh-package oddyssey-mcp oddyssey-mcp==1.13.3
Claude Code에서 oddyssey 사용하기
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를 요청하세요:
@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 서버을(를) 묶습니다.
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에는 어떤 agent가 포함되어 있나요?
k6-benchmark-expert.agent, observe-run.agent, otel-instrumentation-expert.agent, stack-instrumentation-expert.agent입니다. @agent-oddyssey:k6-benchmark-expert.agent로 호출하세요.
oddyssey 플러그인을 어떻게 업데이트하거나 삭제하나요?
shell에서 claude plugin update oddyssey@oddyssey-plugin를 사용하여 업데이트하거나 /plugin의 Installed 탭에서 수행하세요. 삭제하려면 /plugin uninstall oddyssey@oddyssey-plugin을 사용하세요.
oddyssey 플러그인의 라이선스는 무엇인가요?
플러그인 manifest에 명시된 대로 MIT입니다.