{"skill":{"slug":"byterover-2-0-0","displayName":"Byterover 2.0.0","summary":"You MUST use this for gathering contexts before any work. This is a Knowledge management for AI agents. Use `brv` to store and retrieve project patterns, dec...","description":"---\nname: byterover\ndescription: \"You MUST use this for gathering contexts before any work. This is a Knowledge management for AI agents. Use `brv` to store and retrieve project patterns, decisions, and architectural rules in .brv/context-tree. Uses a configured LLM provider (default: ByteRover, no API key needed) for query and curate operations.\"\n---\n\n# ByteRover Knowledge Management\n\nUse 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\n**No 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\n## Workflow\n1.  **Before Thinking:** Run `brv query` to understand existing patterns.\n2.  **After Implementing:** Run `brv curate` to save new patterns/decisions.\n\n## Commands\n\n### 1. Query Knowledge\n**Overview:** Retrieve relevant context from your project's knowledge base. Uses a configured LLM provider to synthesize answers from `.brv/context-tree/` content.\n\n**Use this skill when:**\n- The user wants you to recall something\n- Your context does not contain information you need\n- You need to recall your capabilities or past actions\n- Before performing any action, to check for relevant rules, criteria, or preferences\n\n**Do NOT use this skill when:**\n- The information is already present in your current context\n- The query is about general knowledge, not stored memory\n\n```bash\nbrv query \"How is authentication implemented?\"\n```\n\n### 2. Curate Context\n**Overview**: Analyze and save knowledge to the local knowledge base. Uses a configured LLM provider to categorize and structure the context you provide.\n\n**Use this skill when:**\n- The user wants you to remember something\n- The user intentionally curates memory or knowledge\n- There are meaningful memories from user interactions that should be persisted\n- There are important facts about what you do, what you know, or what decisions and actions you have taken\n\n**Do NOT use this skill when:**\n- The information is already stored and unchanged\n- The information is transient or only relevant to the current task, or just general knowledge\n\n```bash\nbrv curate \"Auth uses JWT with 24h expiry. Tokens stored in httpOnly cookies via authMiddleware.ts\"\n```\n\n**Include source files** (max 5, project-scoped only):\n\n```bash\nbrv curate \"Authentication middleware details\" -f src/middleware/auth.ts\n```\n\n**View curate history:** to check past curations\n- Show recent entries (last 10)\n```bash\nbrv curate view\n```\n- Full detail for a specific entry: all files and operations performed (logId is printed by `brv curate` on completion, e.g. `cur-1739700001000`)\n```bash\nbrv curate view cur-1739700001000\n```\n- List entries with file operations visible (no logId needed)\n```bash\nbrv curate view detail\n```\n- Filter by time and status\n```bash\nbrv curate view --since 1h --status completed\n```\n- For all filter options\n```bash\nbrv curate view --help\n```\n\n### 3. LLM Provider Setup\n`brv query` and `brv curate` require a configured LLM provider. Connect the default ByteRover provider (no API key needed):\n\n```bash\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\n```bash\nbrv providers list\nbrv providers connect openai --api-key sk-xxx --model gpt-4.1\n```\n\n### 4. Cloud Sync (Optional)\n**Overview:** Sync your local knowledge with a team via ByteRover's cloud service. Requires ByteRover authentication.\n\n**Setup steps:**\n1. Log in: Get an API key from your ByteRover account and authenticate:\n```bash\nbrv login --api-key sample-key-string\n```\n2. List available spaces:\n```bash\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```\n3. Connect to a space:\n```bash\nbrv space switch --team human-resources-team --name a-department\n```\n\n**Cloud sync commands:**\nOnce connected, `brv push` and `brv pull` sync with that space.\n```bash\n# Pull team updates\nbrv pull\n\n# Push local changes\nbrv push\n```\n\n**Switching spaces:**\n- Push local changes first (`brv push`) — switching is blocked if unsaved changes exist.\n- Then switch:\n```bash\nbrv space switch --team marketing-team --name d-department\n```\n- The switch automatically pulls context from the new space.\n\n## Data Handling\n\n**Storage**: All knowledge is stored as Markdown files in `.brv/context-tree/` within the project directory. Files are human-readable and version-controllable.\n\n**File 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\n**LLM 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\n**Cloud 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\n## Error Handling\n**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\n**Agent-Fixable Errors:**\nYou MUST handle these errors gracefully and retry the command after fixing.\n\n\"Missing required argument(s).\" | Run `brv <command> --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.\n\n### Quick Diagnosis\nRun `brv status` to check authentication, project, and provider state.\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":681,"installsAllTime":26,"installsCurrent":2,"stars":0,"versions":1},"createdAt":1773621034833,"updatedAt":1779000473828},"latestVersion":{"version":"1.0.0","createdAt":1773621034833,"changelog":"ByteRover Knowledge Management skill initial release:\n\n- Provides `brv` CLI commands for querying and curating project knowledge in `.brv/context-tree` using an LLM provider.\n- Supports local storage with optional cloud sync; no authentication needed for local features.\n- Guides for querying existing knowledge and curating new facts, including file attachments (max 5 per command, project-rooted only).\n- Supports provider configuration (ByteRover by default, no key), with options for other LLM providers.\n- Offers detailed error handling and troubleshooting steps for both user and agent-resolvable issues.\n- Data remains human-readable and version-controllable as Markdown in the project directory.","license":"MIT-0"},"metadata":null,"owner":{"handle":"qxbcn","userId":"s17e3p8e0994506j7d5hq4jz6x884rcq","displayName":"qxbcn","image":"https://avatars.githubusercontent.com/u/14309675?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089907778}}