feat(ide): promote OpenCode to first-class IDE integration by Lokesh7025 · Pull Request #1321 · BlazeUp-AI/Observal

Lokesh7025 · 2026-06-01T05:28:09Z

Fixes

Resolves the OpenCode integration gap, previously listed as "Functional" tier with no telemetry, now upgraded to first-class with full session parsing.

Approach

OpenCode does not write JSONL session files like Claude Code. Instead it stores messages in a SQLite DB accessible via its SDK. The approach:

Plugin-based telemetry A TypeScript plugin (`.opencode/plugins/observal-plugin.ts`) subscribes to OpenCode's `session.idle` event via the catch-all `event:` handler pattern.
SDK-driven message retrieval On each idle event, the plugin uses the OpenCode SDK `client.session.messages()` to fetch the full conversation.
Format conversion Messages are converted to Claude-Code-compatible JSONL format (handling OpenCode's `{created: epoch_ms}` timestamp objects).
Standard ingest Data is POSTed to `/api/v1/ingest/session` with `ide: "opencode"`, reusing the existing Claude Code classifier since the wire format is compatible.

Files changed:

`observal_cli/ide_specs/opencode_hooks_spec.py` (new) Hook spec + plugin source
`observal-server/services/session_parsers/opencode.py` (new) Server-side parser
`observal_cli/ide/opencode.py` , Full CLI adapter (scanning MCPs, skills, agents, hooks)
`observal_cli/ide_registry.py` + `observal-server/schemas/ide_registry.py` Added `skills` feature, `opencode` session parser, updated event map
`observal-server/services/ide/opencode.py` , Full config generation with skills
`observal-server/services/ide/helpers.py` , Proper telemetry plugin source
`observal-server/services/session_ingest.py` , Registered OpenCode extractors
`observal-server/services/session_parsers/init.py` + `ingest_classify.py` Registered parser/classifier

How Has This Been Tested?

Unit tests: All 109 existing tests pass (constants sync, IDE adapters, CLI commands)
Lint: `ruff check` + `ruff format` clean
End-to-end locally: Full Docker stack with enterprise license:
1. `observal pull test --ide opencode` — plugin installed at `.opencode/plugins/`
2. Launched OpenCode, sent messages using the pulled agent
3. Plugin captured session data and pushed to server (verified via debug logging)
4. Data persisted in ClickHouse and visible in the sessions API/frontend

Learning

OpenCode plugins use a catch-all `event: async ({ event }) => {}` handler pattern, NOT individual named event handlers like `"session.idle": async () => {}`
OpenCode timestamps are objects (`{created: epoch_ms}`), not ISO strings needed explicit conversion
The OpenCode SDK `client` object is injected into the plugin context and provides full access to session/message data

Checklist

You have a descriptive commit message with a short title (first line, max 50 chars).
You have commented your code, particularly in hard-to-understand areas
You have performed a self-review of your own code
UI changes: include screenshots of all affected screens N/A (no UI changes)"

Screenshots

- Add full CLI adapter with scanning for MCPs, skills, agents, hooks - Add hook spec with TypeScript plugin for session telemetry - Plugin subscribes to session.idle events, fetches messages via OpenCode SDK, converts to Claude-Code-compatible JSONL, and pushes to the Observal ingest endpoint - Register 'opencode' session parser, classifier, timestamp extractor, usage extractor, and UUID extractor on the server side - Add 'skills' to OpenCode's feature set in IDE registry - Update server adapter to generate skills and proper plugin source - Handle OpenCode's timestamp format ({created: epoch_ms} objects) Tested end-to-end: agent pull -> plugin install -> session capture -> ClickHouse persistence -> frontend visibility.

github-actions · 2026-06-01T05:28:21Z

⚠️ Deprecation Warning: The deny-licenses option is deprecated for possible removal in the next major release. For more information, see issue 997.

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

- Feature matrix now includes 'skills' - Env vars key renamed to 'environment' (OpenCode config format) - Plugin uses execFileSync not execSync - Compatibility warnings test reflects skills support

codecov · 2026-06-01T05:40:42Z

Codecov Report

❌ Patch coverage is 37.83784% with 161 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
observal_cli/ide/opencode.py	20.68%	115 Missing ⚠️
observal-server/api/routes/insights.py	15.78%	16 Missing ⚠️
observal-server/services/ide/helpers.py	65.90%	15 Missing ⚠️
observal_cli/ide_specs/opencode_hooks_spec.py	0.00%	12 Missing ⚠️
observal-server/services/ide/opencode.py	95.83%	1 Missing ⚠️
...serval-server/services/session_parsers/opencode.py	75.00%	1 Missing ⚠️
observal_cli/cmd_pull.py	88.88%	1 Missing ⚠️

📢 Thoughts on this report? Let us know!

Skip built-in agents (build, plan, general, explore, scout, etc.) and only push telemetry for user-pulled Observal agents. Matches behavior of Claude Code (agent-setting detection) and Kiro (per-agent hook commands with OBSERVAL_AGENT_NAME).

- _build_mcp_configs now handles 'mcp' key returned by generate_config for OpenCode (previously MCPs were silently dropped) - config_generator uses 'environment' (not 'env') for OpenCode entries - opencode.py adapter normalizes any remaining 'env' → 'environment' - opencode.py passes skill_configs through as-is for CLI-side install (was pre-rendering via _generate_skill_file causing 'no content' error) - Custom hook components generate per-event plugin files in .opencode/plugins/hook-<name>.ts (command and http handler types) - .opencode/hooks/ added to HOOK_SCRIPTS_DIR for script-based hooks - Update test to expect 'environment' key in MCP config

When pulling an agent with a sandbox component, the generated opencode.json uses bare 'python3' for the observal-sandbox MCP. OpenCode resolves this from its own subprocess PATH which may not include the observal_cli venv, causing a 30s timeout. Rewrite ['python3', '-m', 'observal_cli.*'] command arrays to use sys.executable so the correct interpreter is always used regardless of the environment OpenCode is launched from.

- Replace curl subprocess with Node.js http/https modules for Windows compat - Fix command injection in hook plugins (use shell:true with constant arg) - Fix JSONC comment stripping to handle inline comments - Add message.updated event handling and conditional final flag - Cap sessionState Map to prevent memory leaks in long-lived processes - Remove duplicate plugin source from CLI (delegate to server) - Validate URLs in HTTP hook plugin generation - Fix detect_hooks to not rely on Path.cwd() - Fix frontmatter parsing to only match top-level keys - Restore test coverage for session.created and message.updated - Bump HOOKS_SPEC_VERSION to 2

Haz3-jolt

Please add to supported IDEs in README.md And add screenshots of it in Observal.

Multi-worker uvicorn takes longer to stabilize on startup due to the Redis pubsub subscriber retrying connections. The 15s start_period caused the container to be marked unhealthy before the app fully stabilized, failing CI deploys.

…gured The /status endpoint was showing 'AWS access key not configured' even when insights.api_key was set. Now it reads the API key first and only checks AWS credentials for Bedrock models when no direct key exists.

…r Analytics tab StatusBadge no longer shows indicator dots for approved and pending statuses. Dots remain for active/running states where animation is meaningful. The Analytics tab on the agent detail page was a hardcoded empty state with no real data fetching. Removed it entirely since traces are accessible from the admin dashboard and stats are in the sidebar.

The insights endpoints (session-count, generate, list-reports, get-report, export-html, status) now accept any authenticated user with owner or edit permission on the agent, not just admins. Frontend changes: - Add Insights tab to agent detail page (visible to owners/co-authors) - Shows session count, generate button, and report list - Move report detail route from admin-only to authenticated user level - Remove dots from approved/pending status badges (prior commit)

Insights are now accessed per-agent via the Insights tab on the agent detail page. Admins still see the tab on every agent since they have owner-level permission. Removed: - Sidebar nav entry for /insights - Admin insights index route and page - Retention banner link to /insights (replaced with inline text) - Back button in report detail now uses browser history

Signed-off-by: Hari Srinivasan <harisrini21@gmail.com>

Lokesh7025 · 2026-06-02T02:44:56Z

@Haz3-jolt Screenshots added, and README.md changes done, merge after a final review.

github-actions Bot added cli CLI changes server Pull request touches server code labels Jun 1, 2026

fix(test): update OpenCode e2e tests for first-class feature set

a0ead92

- Feature matrix now includes 'skills' - Env vars key renamed to 'environment' (OpenCode config format) - Plugin uses execFileSync not execSync - Compatibility warnings test reflects skills support

github-actions Bot added the tests Pull request adds or modifies tests label Jun 1, 2026

Lokesh7025 added 3 commits June 1, 2026 10:18

Lokesh7025 force-pushed the feature/opencode-integration branch from f1e3ce1 to 8b5adcf Compare June 1, 2026 12:40

Lokesh7025 force-pushed the feature/opencode-integration branch from 8b5adcf to f35821a Compare June 1, 2026 12:44

Haz3-jolt approved these changes Jun 1, 2026

View reviewed changes

Lokesh7025 and others added 9 commits June 2, 2026 06:42

ec2 terraform deploy script

2a4b0df

bump(release): v1.4.4

db7ea3f

Signed-off-by: Hari Srinivasan <harisrini21@gmail.com>

ec2 terraform deploy script

b6e93b8

docs: add OpenCode to supported IDEs list

8e3e81b

github-actions Bot added the web Pull request touches web frontend code label Jun 2, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(ide): promote OpenCode to first-class IDE integration#1321

feat(ide): promote OpenCode to first-class IDE integration#1321
Lokesh7025 wants to merge 15 commits into
mainfrom
feature/opencode-integration

Lokesh7025 commented Jun 1, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jun 1, 2026 •

edited

Loading

Uh oh!

codecov Bot commented Jun 1, 2026 •

edited

Loading

Uh oh!

Haz3-jolt left a comment •

edited

Loading

Uh oh!

Lokesh7025 commented Jun 2, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

Lokesh7025 commented Jun 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Fixes

Approach

Files changed:

How Has This Been Tested?

Learning

Checklist

Screenshots

Uh oh!

github-actions Bot commented Jun 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Dependency Review

Scanned Files

Uh oh!

codecov Bot commented Jun 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

Haz3-jolt left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Lokesh7025 commented Jun 2, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Lokesh7025 commented Jun 1, 2026 •

edited

Loading

github-actions Bot commented Jun 1, 2026 •

edited

Loading

codecov Bot commented Jun 1, 2026 •

edited

Loading

Haz3-jolt left a comment •

edited

Loading