{ "schemaVersion": "1.0", "item": { "slug": "byterover", "name": "ByteRover", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/byteroverinc/byterover", "canonicalUrl": "https://clawhub.ai/byteroverinc/byterover", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/byterover", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=byterover", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "slug": "byterover", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T04:41:39.514Z", "expiresAt": "2026-05-07T04:41:39.514Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=byterover", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=byterover", "contentDisposition": "attachment; filename=\"byterover-3.3.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "byterover" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/byterover" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/byterover", "agentPageUrl": "https://openagent3.xyz/skills/byterover/agent", "manifestUrl": "https://openagent3.xyz/skills/byterover/agent.json", "briefUrl": "https://openagent3.xyz/skills/byterover/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "ByteRover Knowledge Management", "body": "Use the brv CLI to manage your project's long-term memory.\nInstall: npm install -g byterover-cli\nKnowledge is stored in .brv/context-tree/ as human-readable Markdown files.\n\nNo authentication needed. brv query and brv curate work out of the box. Login is only required for cloud sync (push/pull/space) — ignore those if you don't need cloud features." }, { "title": "Workflow", "body": "Before Thinking: Run brv query to understand existing patterns.\nAfter Implementing: Run brv curate to save new patterns/decisions." }, { "title": "1. Query Knowledge", "body": "Overview: Retrieve relevant context from your project's knowledge base. Uses a configured LLM provider to synthesize answers from .brv/context-tree/ content.\n\nUse this skill when:\n\nThe user wants you to recall something\nYour context does not contain information you need\nYou need to recall your capabilities or past actions\nBefore performing any action, to check for relevant rules, criteria, or preferences\n\nDo NOT use this skill when:\n\nThe information is already present in your current context\nThe query is about general knowledge, not stored memory\n\nbrv query \"How is authentication implemented?\"" }, { "title": "2. Curate Context", "body": "Overview: Analyze and save knowledge to the local knowledge base. Uses a configured LLM provider to categorize and structure the context you provide.\n\nUse this skill when:\n\nThe user wants you to remember something\nThe user intentionally curates memory or knowledge\nThere are meaningful memories from user interactions that should be persisted\nThere are important facts about what you do, what you know, or what decisions and actions you have taken\n\nDo NOT use this skill when:\n\nThe information is already stored and unchanged\nThe information is transient or only relevant to the current task, or just general knowledge\n\nbrv curate \"Auth uses JWT with 24h expiry. Tokens stored in httpOnly cookies via authMiddleware.ts\"\n\nInclude source files (max 5, project-scoped only):\n\nbrv curate \"Authentication middleware details\" -f src/middleware/auth.ts\n\nView curate history: to check past curations\n\nShow recent entries (last 10)\n\nbrv curate view\n\nFull detail for a specific entry: all files and operations performed (logId is printed by brv curate on completion, e.g. cur-1739700001000)\n\nbrv curate view cur-1739700001000\n\nList entries with file operations visible (no logId needed)\n\nbrv curate view detail\n\nFilter by time and status\n\nbrv curate view --since 1h --status completed\n\nFor all filter options\n\nbrv curate view --help" }, { "title": "3. LLM Provider Setup", "body": "brv query and brv curate require a configured LLM provider. Connect the default ByteRover provider (no API key needed):\n\nbrv providers connect byterover\n\nTo use a different provider (e.g., OpenAI, Anthropic, Google), list available options and connect with your own API key:\n\nbrv providers list\nbrv providers connect openai --api-key sk-xxx --model gpt-4.1" }, { "title": "4. Cloud Sync (Optional)", "body": "Overview: Sync your local knowledge with a team via ByteRover's cloud service. Requires ByteRover authentication.\n\nSetup steps:\n\nLog in: Get an API key from your ByteRover account and authenticate:\n\nbrv login --api-key sample-key-string\n\nList available spaces:\n\nbrv space list\n\nSample output:\n\nbrv space list\n1. human-resources-team (team)\n - a-department (space)\n - b-department (space)\n2. marketing-team (team)\n - c-department (space)\n - d-department (space)\n\nConnect to a space:\n\nbrv space switch --team human-resources-team --name a-department\n\nCloud sync commands:\nOnce connected, brv push and brv pull sync with that space.\n\n# Pull team updates\nbrv pull\n\n# Push local changes\nbrv push\n\nSwitching spaces:\n\nPush local changes first (brv push) — switching is blocked if unsaved changes exist.\nThen switch:\n\nbrv space switch --team marketing-team --name d-department\n\nThe switch automatically pulls context from the new space." }, { "title": "Data Handling", "body": "Storage: All knowledge is stored as Markdown files in .brv/context-tree/ within the project directory. Files are human-readable and version-controllable.\n\nFile access: The -f flag on brv curate reads files from the current project directory only. Paths outside the project root are rejected. Maximum 5 files per command, text and document formats only.\n\nLLM usage: brv query and brv curate send context to a configured LLM provider for processing. The LLM sees the query or curate text and any included file contents. No data is sent to ByteRover servers unless you explicitly run brv push.\n\nCloud sync: brv push and brv pull require authentication (brv login) and send knowledge to ByteRover's cloud service. All other commands operate without ByteRover authentication." }, { "title": "Error Handling", "body": "User Action Required:\nYou MUST show this troubleshooting guide to users when errors occur.\n\n\"Not authenticated\" | Run brv login --help for more details.\n\"No provider connected\" | Run brv providers connect byterover (free, no key needed).\n\"Connection failed\" / \"Instance crashed\" | User should kill brv process.\n\"Token has expired\" / \"Token is invalid\" | Run brv login again to re-authenticate.\n\"Billing error\" / \"Rate limit exceeded\" | User should check account credits or wait before retrying.\n\nAgent-Fixable Errors:\nYou MUST handle these errors gracefully and retry the command after fixing.\n\n\"Missing required argument(s).\" | Run brv --help to see usage instructions.\n\"Maximum 5 files allowed\" | Reduce to 5 or fewer -f flags per curate.\n\"File does not exist\" | Verify path with ls, use relative paths from project root.\n\"File type not supported\" | Only text, image, PDF, and office files are supported." }, { "title": "Quick Diagnosis", "body": "Run brv status to check authentication, project, and provider state." } ], "body": "ByteRover Knowledge Management\n\nUse the brv CLI to manage your project's long-term memory. Install: npm install -g byterover-cli Knowledge is stored in .brv/context-tree/ as human-readable Markdown files.\n\nNo authentication needed. brv query and brv curate work out of the box. Login is only required for cloud sync (push/pull/space) — ignore those if you don't need cloud features.\n\nWorkflow\nBefore Thinking: Run brv query to understand existing patterns.\nAfter Implementing: Run brv curate to save new patterns/decisions.\nCommands\n1. Query Knowledge\n\nOverview: Retrieve relevant context from your project's knowledge base. Uses a configured LLM provider to synthesize answers from .brv/context-tree/ content.\n\nUse this skill when:\n\nThe user wants you to recall something\nYour context does not contain information you need\nYou need to recall your capabilities or past actions\nBefore performing any action, to check for relevant rules, criteria, or preferences\n\nDo NOT use this skill when:\n\nThe information is already present in your current context\nThe query is about general knowledge, not stored memory\nbrv query \"How is authentication implemented?\"\n\n2. Curate Context\n\nOverview: Analyze and save knowledge to the local knowledge base. Uses a configured LLM provider to categorize and structure the context you provide.\n\nUse this skill when:\n\nThe user wants you to remember something\nThe user intentionally curates memory or knowledge\nThere are meaningful memories from user interactions that should be persisted\nThere are important facts about what you do, what you know, or what decisions and actions you have taken\n\nDo NOT use this skill when:\n\nThe information is already stored and unchanged\nThe information is transient or only relevant to the current task, or just general knowledge\nbrv curate \"Auth uses JWT with 24h expiry. Tokens stored in httpOnly cookies via authMiddleware.ts\"\n\n\nInclude source files (max 5, project-scoped only):\n\nbrv curate \"Authentication middleware details\" -f src/middleware/auth.ts\n\n\nView curate history: to check past curations\n\nShow recent entries (last 10)\nbrv curate view\n\nFull detail for a specific entry: all files and operations performed (logId is printed by brv curate on completion, e.g. cur-1739700001000)\nbrv curate view cur-1739700001000\n\nList entries with file operations visible (no logId needed)\nbrv curate view detail\n\nFilter by time and status\nbrv curate view --since 1h --status completed\n\nFor all filter options\nbrv curate view --help\n\n3. LLM Provider Setup\n\nbrv query and brv curate require a configured LLM provider. Connect the default ByteRover provider (no API key needed):\n\nbrv providers connect byterover\n\n\nTo use a different provider (e.g., OpenAI, Anthropic, Google), list available options and connect with your own API key:\n\nbrv providers list\nbrv providers connect openai --api-key sk-xxx --model gpt-4.1\n\n4. Cloud Sync (Optional)\n\nOverview: Sync your local knowledge with a team via ByteRover's cloud service. Requires ByteRover authentication.\n\nSetup steps:\n\nLog in: Get an API key from your ByteRover account and authenticate:\nbrv login --api-key sample-key-string\n\nList available spaces:\nbrv space list\n\n\nSample output:\n\nbrv space list\n1. human-resources-team (team)\n - a-department (space)\n - b-department (space)\n2. marketing-team (team)\n - c-department (space)\n - d-department (space)\n\nConnect to a space:\nbrv space switch --team human-resources-team --name a-department\n\n\nCloud sync commands: Once connected, brv push and brv pull sync with that space.\n\n# Pull team updates\nbrv pull\n\n# Push local changes\nbrv push\n\n\nSwitching spaces:\n\nPush local changes first (brv push) — switching is blocked if unsaved changes exist.\nThen switch:\nbrv space switch --team marketing-team --name d-department\n\nThe switch automatically pulls context from the new space.\nData Handling\n\nStorage: All knowledge is stored as Markdown files in .brv/context-tree/ within the project directory. Files are human-readable and version-controllable.\n\nFile access: The -f flag on brv curate reads files from the current project directory only. Paths outside the project root are rejected. Maximum 5 files per command, text and document formats only.\n\nLLM usage: brv query and brv curate send context to a configured LLM provider for processing. The LLM sees the query or curate text and any included file contents. No data is sent to ByteRover servers unless you explicitly run brv push.\n\nCloud sync: brv push and brv pull require authentication (brv login) and send knowledge to ByteRover's cloud service. All other commands operate without ByteRover authentication.\n\nError Handling\n\nUser Action Required: You MUST show this troubleshooting guide to users when errors occur.\n\n\"Not authenticated\" | Run brv login --help for more details. \"No provider connected\" | Run brv providers connect byterover (free, no key needed). \"Connection failed\" / \"Instance crashed\" | User should kill brv process. \"Token has expired\" / \"Token is invalid\" | Run brv login again to re-authenticate. \"Billing error\" / \"Rate limit exceeded\" | User should check account credits or wait before retrying.\n\nAgent-Fixable Errors: You MUST handle these errors gracefully and retry the command after fixing.\n\n\"Missing required argument(s).\" | Run brv --help to see usage instructions. \"Maximum 5 files allowed\" | Reduce to 5 or fewer -f flags per curate. \"File does not exist\" | Verify path with ls, use relative paths from project root. \"File type not supported\" | Only text, image, PDF, and office files are supported.\n\nQuick Diagnosis\n\nRun brv status to check authentication, project, and provider state." }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/byteroverinc/byterover", "publisherUrl": "https://clawhub.ai/byteroverinc/byterover", "owner": "byteroverinc", "version": "2.0.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/byterover", "downloadUrl": "https://openagent3.xyz/downloads/byterover", "agentUrl": "https://openagent3.xyz/skills/byterover/agent", "manifestUrl": "https://openagent3.xyz/skills/byterover/agent.json", "briefUrl": "https://openagent3.xyz/skills/byterover/agent.md" } }