{"id":49309698,"url":"https://github.com/ian-pascoe/opencode-byterover","last_synced_at":"2026-04-26T12:01:39.307Z","repository":{"id":353604314,"uuid":"1219993643","full_name":"ian-pascoe/opencode-byterover","owner":"ian-pascoe","description":"ByteRover plugin for OpenCode","archived":false,"fork":false,"pushed_at":"2026-04-24T17:22:03.000Z","size":48,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-24T17:24:25.810Z","etag":null,"topics":["ai","byterover","memory","opencode"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/opencode-byterover","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ian-pascoe.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"ian-pascoe"}},"created_at":"2026-04-24T12:40:05.000Z","updated_at":"2026-04-24T16:56:10.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ian-pascoe/opencode-byterover","commit_stats":null,"previous_names":["ian-pascoe/opencode-byterover"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ian-pascoe/opencode-byterover","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ian-pascoe%2Fopencode-byterover","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ian-pascoe%2Fopencode-byterover/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ian-pascoe%2Fopencode-byterover/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ian-pascoe%2Fopencode-byterover/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ian-pascoe","download_url":"https://codeload.github.com/ian-pascoe/opencode-byterover/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ian-pascoe%2Fopencode-byterover/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32282243,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-25T18:29:39.964Z","status":"ssl_error","status_checked_at":"2026-04-25T18:29:32.149Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","byterover","memory","opencode"],"created_at":"2026-04-26T12:01:38.683Z","updated_at":"2026-04-26T12:01:39.298Z","avatar_url":"https://github.com/ian-pascoe.png","language":"TypeScript","funding_links":["https://github.com/sponsors/ian-pascoe"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align='center'\u003e\n    \u003cbr/\u003e\n    \u003cbr/\u003e\n    \u003ch3\u003eopencode-byterover\u003c/h3\u003e\n    \u003cp\u003eByteRover memory integration for OpenCode.\u003c/p\u003e\n    \u003ca href=\"https://www.npmjs.com/package/opencode-byterover\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/opencode-byterover?style=for-the-badge\u0026logo=npm\u0026label=npm\u0026color=cb3837\" alt=\"npm version\" /\u003e\u003c/a\u003e\n    \u003cbr/\u003e\n    \u003cbr/\u003e\n\u003c/div\u003e\n\n## Overview\n\n`opencode-byterover` is an OpenCode plugin that connects OpenCode sessions to ByteRover through `@byterover/brv-bridge`.\n\nThe plugin persists useful session context when sessions become idle or compact, then recalls relevant context during system prompt transformation.\n\n## Prerequisites\n\n- OpenCode with plugin support enabled.\n- ByteRover CLI installed and available as `brv`, or a custom executable path configured with `brvPath`.\n- ByteRover initialized for the project you want OpenCode to use as memory.\n\nVerify the CLI is reachable before enabling the plugin:\n\n```bash\nbrv --help\n```\n\n## Installation\n\nAdd the plugin to your OpenCode configuration:\n\n```json\n{\n  \"$schema\": \"https://opencode.ai/config.json\",\n  \"plugin\": [\"opencode-byterover\"]\n}\n```\n\nFor custom settings, use the tuple form shown below.\n\n## Verify Setup\n\nAfter starting OpenCode in a repository with the plugin enabled:\n\n- `.brv/.gitignore` should be created or updated with an `opencode-byterover` managed block.\n- OpenCode logs should include entries with `service: \"byterover\"`.\n- If ByteRover is unavailable, OpenCode should show a warning toast unless `quiet` is enabled.\n\n## Configuration\n\nThe plugin accepts these optional settings:\n\n- `enabled`: enable or disable the plugin without removing it from config. Defaults to `true`.\n- `brvPath`: custom ByteRover CLI path. Defaults to `brv` (assuming it's in the system `PATH`).\n- `searchTimeoutMs`: ByteRover search timeout in milliseconds. Defaults to `15000`.\n- `recallTimeoutMs`: ByteRover recall timeout in milliseconds. Defaults to `15000`.\n- `persistTimeoutMs`: ByteRover persist timeout in milliseconds. Defaults to `15000`.\n- `quiet`: suppress toast notifications for ByteRover operations. Defaults to `false`.\n- `autoRecall`: automatically recall and inject ByteRover context into prompts. Defaults to `true`.\n- `autoPersist`: automatically curate session turns into ByteRover. Defaults to `true`.\n- `contextTagName`: XML-style tag name used for injected recall context. Defaults to `byterover-context`.\n- `recallPrompt`: custom instruction text used before the recent conversation sent to ByteRover recall.\n- `persistPrompt`: custom instruction text used before the conversation turn sent to ByteRover curation.\n- `maxRecallTurns`: maximum recent user turns used to resolve recall context. Defaults to `3`.\n- `maxRecallChars`: maximum recent conversation characters used for recall. Defaults to `4096`.\n\nNumeric timeout and limit values must be positive integers. `brvPath`, `recallPrompt`, and `persistPrompt` must be non-empty strings. `contextTagName` must be a simple XML-style tag name such as `byterover-context`.\n\n### Example\n\n```json\n{\n  \"$schema\": \"https://opencode.ai/config.json\",\n  \"plugin\": [\n    [\n      \"opencode-byterover\",\n      {\n        \"enabled\": true,\n        \"brvPath\": \"brv\",\n        \"searchTimeoutMs\": 15000,\n        \"recallTimeoutMs\": 15000,\n        \"persistTimeoutMs\": 15000,\n        \"autoRecall\": true,\n        \"autoPersist\": true,\n        \"contextTagName\": \"byterover-context\",\n        \"recallPrompt\": \"Recall relevant project context for the latest user request.\",\n        \"persistPrompt\": \"Curate durable facts, decisions, preferences, and technical details.\",\n        \"maxRecallTurns\": 3,\n        \"maxRecallChars\": 4096\n      }\n    ]\n  ]\n}\n```\n\n## Development\n\n```bash\npnpm install\npnpm format:check\npnpm lint\npnpm test\npnpm typecheck\npnpm build\n```\n\n## Releases\n\nThis package uses Changesets and GitHub Actions for releases.\n\nCreate a release note for user-facing changes:\n\n```bash\npnpm changeset\n```\n\nMerging the generated release PR publishes the package to npm through trusted publishing.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fian-pascoe%2Fopencode-byterover","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fian-pascoe%2Fopencode-byterover","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fian-pascoe%2Fopencode-byterover/lists"}