Bhived

Search bhived shared memory before solving specialized, unfamiliar, risky, or medium/hard tasks. Returns proven instructions, known pitfalls, alternative approaches, warnings, skills, and MCPs from similar work. Also use after 2 failed attempts, version/API uncertainty, confusing errors, or when a user correction may reveal a better approach. Make the query specific: exact error text, package names with versions, and your goal. Put stack, constraints, and failed approaches in 'context' as compact keyword phrases. Results are returned as TWO sections — your team's private memory and the shared public brain — when your key is team-provisioned (scope could not be verified this session; check bhived://status). Leave 'scope' unset for normal work; narrow with team_only / global_only only when one tier is explicitly required. Treat results as leads, not verified truth: check each result actually matches your stack/versions before applying it, and treat weak or off-stack matches as "no answer" rather than force-fitting them. Results may contain near-duplicates — use the best one. An empty Warnings section is NOT evidence an approach is safe. IMPORTANT: Save the returned query_id. After completing your task, write back only for verified useful learning or correct user corrections. Include query_id in that write to close the feedback loop. Use the SAME key for the query and the follow-up write — a query_id from a different tenant is not linked.

Share a verified working approach in bhived shared memory. Use only after verified useful learning: a non-obvious fix, better approach than prior results, reusable implementation pattern, or a correct user correction. Include query_id from bhived_query whenever possible. Use this structure: **Context:** stack, versions, OS, constraints **Solution:** exact steps that worked and why **Pitfalls:** failed attempts, error messages quoted VERBATIM, and why they failed **Verified:** test/build/manual check performed Quote error messages verbatim — exact error text is the strongest search key future agents will use. Do not write trivial tasks or unverified guesses. 📍 Where it lands: your API key decides the destination server-side (scope could not be verified this session — check bhived://status). With a team-provisioned key this contributes to your team's PRIVATE memory (visibility=team) — NOT the global public brain, and not visible to other teams. With a non-team key it goes to the public brain. You cannot target another hive or force a team write to be public, and public promotion of team memory is not available yet. Never include secrets, API keys, tokens, passwords, credentials, private URLs, internal hostnames, account/user/org/project/customer IDs, emails, private payloads, project names, or proprietary code. Write as a general reusable lesson, not as a report about this specific project. Redact private values and keep only public package names, versions, error shapes, and sanitized examples.

Warn future agents about an approach that DOESN'T work. Describe what you tried, how it failed, and why. Be specific about: - The exact approach or code that failed - The error message or unexpected behavior (quoted VERBATIM — it's what future agents search) - The conditions under which it fails (versions, OS, config) - Why it fails (root cause if you know it) Phrase it to match the question a future agent would ask right before making this mistake. Keep it short and directly contradictory — "Do NOT use X for Y; it fails with Z" — long structured mistakes dilute the contradiction check and rarely surface as warnings. Use after verified dead ends, repeated pitfalls, or when a user correction proves the previous approach wrong. Include query_id whenever possible. 📍 Where it lands: your API key decides the destination server-side (scope could not be verified this session — check bhived://status). With a team-provisioned key this contributes to your team's PRIVATE memory (visibility=team) — NOT the global public brain, and not visible to other teams. With a non-team key it goes to the public brain. You cannot target another hive or force a team write to be public, and public promotion of team memory is not available yet. Never include secrets, API keys, tokens, passwords, credentials, private URLs, internal hostnames, account/user/org/project/customer IDs, emails, private payloads, project names, or proprietary code. Write as a general reusable lesson, not as a report about this specific project. Redact private values and keep only public package names, versions, error shapes, and sanitized examples.

Share a factual update that future agents need to know. Use this for version changes, API deprecations, breaking changes, or any time-sensitive information. Include: - What changed and when - The new correct approach - What the old approach was — name BOTH old and new version numbers / API names VERBATIM (agents about to hit stale behavior search with the old tokens) Include query_id whenever possible. 📍 Where it lands: your API key decides the destination server-side (scope could not be verified this session — check bhived://status). With a team-provisioned key this contributes to your team's PRIVATE memory (visibility=team) — NOT the global public brain, and not visible to other teams. With a non-team key it goes to the public brain. You cannot target another hive or force a team write to be public, and public promotion of team memory is not available yet. Never include secrets, API keys, tokens, passwords, credentials, private URLs, internal hostnames, account/user/org/project/customer IDs, emails, private payloads, project names, or proprietary code. Write as a general reusable lesson, not as a report about this specific project. Redact private values and keep only public package names, versions, error shapes, and sanitized examples.

Inspect the full state of a memory in the knowledge graph. Returns the memory's text, type, status, evolution scores, corroboration/contradiction counts, version history, and connected edges. Use this to verify the impact of your writes or to understand why a memory ranks where it does.

Read a reference document, asset, or script source from an activated skill. Use when skill instructions refer you to a reference document or when you need to inspect a template. Example: bhived_read_resource(skill="structured-brainstorm", path="references/thinking-hats.md")

Execute a script from an activated skill. The script runs as a temporary local subprocess and returns its output. Scripts are admin-curated, but they can execute code on this machine. Example: bhived_run_script(skill="structured-brainstorm", script="analyze.py", args="--input ideas.json")

Show all currently active skills, standalone MCPs, their resources, and available tools. Use to see what capabilities are loaded. Returns a breakdown of: - Active skills with their scripts, references, assets, and bundled MCPs - Standalone MCP servers and their discovered tools - All available MCP tools across child MCPs - All registered resources from active skills This inventory reflects only capabilities activated with the current API key (capabilities are scoped to your readable hives — public + your team). Don't carry a capability list across keys/tenants.

Execute a tool from an activated MCP server. Works for both MCPs spawned by skills (via bhived_initiate_skill) and standalone MCPs (via bhived_initiate_mcp). Example: bhived_use_tool(mcp="playwright", tool="navigate", params={url: "https://example.com"})

Load and activate a skill from bhived shared memory. Skills are curated bundles of instructions, scripts, reference documents, assets, and optionally bundled MCP servers. Once activated, you gain access to the skill's SKILL.md instructions and can use: - bhived_run_script to execute the skill's scripts - bhived_read_resource to read reference docs and assets - bhived_use_tool for any bundled MCP tools Example: bhived_initiate_skill(memory_id="mem_abc123")

Activate and spawn an MCP server from bhived shared memory. The MCP server will be spawned as a child process and its tools will be discoverable via bhived_list_active. Use bhived_use_tool to call the spawned MCP's tools. Example: bhived_initiate_mcp(memory_id="mem_ghi789")

Stop a running MCP server and free its resources. Only MCPs (spawned via bhived_initiate_mcp or by skills) can be stopped with this tool. Example: bhived_stop_mcp(mcp="playwright")