lbrain-coding-agents 0.1.0__tar.gz

lbrain_coding_agents-0.1.0/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Metavolve Labs, Inc.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

lbrain_coding_agents-0.1.0/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: lbrain-coding-agents
+Version: 0.1.0
+Summary: Install LBrain into coding agents: native MCP, companion skill, fail-closed session start.
+Author: Metavolve Labs, Inc.
+License: BSD-3-Clause
+Project-URL: Homepage, https://lbrain.ai
+Project-URL: Source, https://github.com/metavolve-labs/lbrain-coding-agents
+Project-URL: Issues, https://github.com/metavolve-labs/lbrain-coding-agents/issues
+Keywords: lbrain,mcp,agent-memory,claude-code,codex,grok
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# LBrain coding-agents
+
+Install LBrain where the agent already lives.
+
+Native MCP + companion skill + fail-closed session-start for Claude Code, Codex, Cursor, Copilot, Grok Build, Gemini CLI, Antigravity, and OpenClaw.
+
+This package does **not** modify the LBrain engine. It wires hosts to `lbrain mcp`.
+
+## Install the engine first
+
+```bash
+pip install "lbrain[local]"
+lbrain init --source ~/notes
+lbrain import && lbrain embed --stale
+```
+
+## Wire your coding agents
+
+```bash
+pip install lbrain-coding-agents
+python3 -m lbrain_agents status
+python3 -m lbrain_agents install            # lists detections, changes nothing
+python3 -m lbrain_agents install all        # every detected harness
+python3 -m lbrain_agents install claude-code grok-build
+python3 -m lbrain_agents install all --dry-run
+```
+
+A bare `install` is a no-op. That is deliberate: wiring every agent on the machine never happens by accident.
+
+## Paste to a desktop AI (no terminal)
+
+Some people never open a shell. They paste this into Claude, Cursor, Codex, Copilot, or Grok and the agent does the work:
+
+```
+Install LBrain as my local memory.
+
+pip install "lbrain[local]" lbrain-coding-agents
+If python3 -m lbrain_agents works here, run: python3 -m lbrain_agents install all
+Otherwise add an MCP server named lbrain: command lbrain, args ["mcp"], stdio.
+
+Then call whoami. Prefer binds. Near-miss is not an answer. Abstain if nothing binds. SUPERSEDED must not govern. Leave LBRAIN_HOME alone if it is already set.
+
+https://lbrain.ai/integrations.html
+```
+
+Existing `lbrain` MCP entries are left untouched unless you pass `--force`. Skills are copied to each host's skills directory. Session-start injects `lbrain whoami` (Claude Code).
+
+## Two-line wrap
+
+```python
+from openai import OpenAI
+from lbrain_agents.wrap import wrap_openai
+
+client = wrap_openai(OpenAI(), home="~/.lbrain")
+```
+
+Recall first. If nothing binds, the model is told to abstain. Writes are opt-in (`remember=True`).
+
+## Agent Plugin
+
+`lbrain_agents/share/agent-plugin/` is a portable bundle (`plugin.json` + `mcp.json` + skill) for hosts that speak the Agent Plugins spec.
+
+## Cookbooks
+
+1. Abstain when the record does not bind
+2. SUPERSEDED does not govern
+3. Model swap, same mind
+
+See `lbrain_agents/share/cookbooks/`.
+
+## Safety
+
+- Merges only the `lbrain` key. Other MCP servers stay.
+- Backs up a config once as `*.lbrain-backup` before the first write.
+- Does not set `LBRAIN_HOME` unless you pass `--home`. A working seat mount is not overwritten.
+- HTTP MCP is **not** enabled by this installer. stdio only. The engine's HTTP transport has no auth; do not bind it to the world.
+
+## What this package is not
+
+This is the free installer and the serve-boundary skill. It is not LBrain Connect, Managed LBrain, or LBrain Govern. It does not issue `gcx://` names, inscribe permanence, or ship study gold sets. The engine's resolver client is open; registrar issuance is not in this tree.
+
+## License
+
+BSD-3-Clause. Metavolve Labs, Inc.
+
+Patents pending. The licence covers the code; it does not grant patent rights.

lbrain_coding_agents-0.1.0/README.md

@@ -0,0 +1,86 @@
+# LBrain coding-agents
+
+Install LBrain where the agent already lives.
+
+Native MCP + companion skill + fail-closed session-start for Claude Code, Codex, Cursor, Copilot, Grok Build, Gemini CLI, Antigravity, and OpenClaw.
+
+This package does **not** modify the LBrain engine. It wires hosts to `lbrain mcp`.
+
+## Install the engine first
+
+```bash
+pip install "lbrain[local]"
+lbrain init --source ~/notes
+lbrain import && lbrain embed --stale
+```
+
+## Wire your coding agents
+
+```bash
+pip install lbrain-coding-agents
+python3 -m lbrain_agents status
+python3 -m lbrain_agents install            # lists detections, changes nothing
+python3 -m lbrain_agents install all        # every detected harness
+python3 -m lbrain_agents install claude-code grok-build
+python3 -m lbrain_agents install all --dry-run
+```
+
+A bare `install` is a no-op. That is deliberate: wiring every agent on the machine never happens by accident.
+
+## Paste to a desktop AI (no terminal)
+
+Some people never open a shell. They paste this into Claude, Cursor, Codex, Copilot, or Grok and the agent does the work:
+
+```
+Install LBrain as my local memory.
+
+pip install "lbrain[local]" lbrain-coding-agents
+If python3 -m lbrain_agents works here, run: python3 -m lbrain_agents install all
+Otherwise add an MCP server named lbrain: command lbrain, args ["mcp"], stdio.
+
+Then call whoami. Prefer binds. Near-miss is not an answer. Abstain if nothing binds. SUPERSEDED must not govern. Leave LBRAIN_HOME alone if it is already set.
+
+https://lbrain.ai/integrations.html
+```
+
+Existing `lbrain` MCP entries are left untouched unless you pass `--force`. Skills are copied to each host's skills directory. Session-start injects `lbrain whoami` (Claude Code).
+
+## Two-line wrap
+
+```python
+from openai import OpenAI
+from lbrain_agents.wrap import wrap_openai
+
+client = wrap_openai(OpenAI(), home="~/.lbrain")
+```
+
+Recall first. If nothing binds, the model is told to abstain. Writes are opt-in (`remember=True`).
+
+## Agent Plugin
+
+`lbrain_agents/share/agent-plugin/` is a portable bundle (`plugin.json` + `mcp.json` + skill) for hosts that speak the Agent Plugins spec.
+
+## Cookbooks
+
+1. Abstain when the record does not bind
+2. SUPERSEDED does not govern
+3. Model swap, same mind
+
+See `lbrain_agents/share/cookbooks/`.
+
+## Safety
+
+- Merges only the `lbrain` key. Other MCP servers stay.
+- Backs up a config once as `*.lbrain-backup` before the first write.
+- Does not set `LBRAIN_HOME` unless you pass `--home`. A working seat mount is not overwritten.
+- HTTP MCP is **not** enabled by this installer. stdio only. The engine's HTTP transport has no auth; do not bind it to the world.
+
+## What this package is not
+
+This is the free installer and the serve-boundary skill. It is not LBrain Connect, Managed LBrain, or LBrain Govern. It does not issue `gcx://` names, inscribe permanence, or ship study gold sets. The engine's resolver client is open; registrar issuance is not in this tree.
+
+## License
+
+BSD-3-Clause. Metavolve Labs, Inc.
+
+Patents pending. The licence covers the code; it does not grant patent rights.

lbrain_coding_agents-0.1.0/lbrain_agents/__init__.py

@@ -0,0 +1,3 @@
+"""LBrain coding-agent installer. Does not import the LBrain engine."""
+
+__version__ = "0.1.0"

lbrain_coding_agents-0.1.0/lbrain_agents/__main__.py

@@ -0,0 +1,4 @@
+from lbrain_agents.cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

lbrain_coding_agents-0.1.0/lbrain_agents/cli.py

@@ -0,0 +1,158 @@
+"""CLI: lbrain-agents install|uninstall|status|wrap-help"""
+
+from __future__ import annotations
+
+import argparse
+import sys
+from typing import List, Optional
+
+from lbrain_agents.installer import (
+    ALL_HARNESSES,
+    Action,
+    detected_harnesses,
+    install,
+    resolve_lbrain_bin,
+    runtime_dir,
+)
+
+
+def _print_actions(actions: List[Action]) -> int:
+    width = max((len(a.harness) for a in actions), default=8)
+    changed = 0
+    for a in actions:
+        mark = "CHANGE" if a.changed else "ok    "
+        if a.kind == "error":
+            mark = "ERROR "
+        print(f"  {mark}  {a.harness.ljust(width)}  {a.kind:6}  {a.detail}")
+        if a.changed:
+            changed += 1
+        if a.kind == "error":
+            return 2
+    print(f"\n{changed} change(s). Runtime: {runtime_dir()}")
+    return 0
+
+
+def cmd_status(_: argparse.Namespace) -> int:
+    binary = resolve_lbrain_bin()
+    missing = "NOT ON PATH (pip install lbrain[local])"
+    print("lbrain binary: " + (binary or missing))
+    print(f"runtime dir:   {runtime_dir()}")
+    print("harnesses:")
+    present = detected_harnesses()
+    for name in ALL_HARNESSES:
+        print(f"  {'yes' if present[name] else 'no ':3}  {name}")
+    return 0 if binary else 1
+
+
+def cmd_install(args: argparse.Namespace) -> int:
+    targets = list(args.harness or [])
+    if not targets:
+        print("No harness named. Detected on this machine:\n")
+        present = detected_harnesses()
+        for name in ALL_HARNESSES:
+            flag = "detected" if present[name] else "absent  "
+            print(f"  {flag}  {name}")
+        print("\nInstall with:  lbrain-agents install all")
+        print("         or:  lbrain-agents install claude-code grok-build")
+        print("A bare install changes nothing.")
+        return 0
+    if targets == ["all"]:
+        targets = list(ALL_HARNESSES)
+    unknown = [t for t in targets if t not in ALL_HARNESSES]
+    if unknown:
+        print("Unknown harness:", ", ".join(unknown), file=sys.stderr)
+        print("Known:", ", ".join(ALL_HARNESSES), file=sys.stderr)
+        return 2
+    if not resolve_lbrain_bin():
+        print(
+            'lbrain is not on PATH. Install the engine first:\n  pip install "lbrain[local]"',
+            file=sys.stderr,
+        )
+        return 1
+    print("LBrain coding-agents" + (" (dry-run)" if args.dry_run else ""))
+    actions = install(
+        targets,
+        home=args.home,
+        persona=args.persona,
+        dry_run=args.dry_run,
+        force=args.force,
+        detected_only=not args.force_absent,
+    )
+    return _print_actions(actions)
+
+
+def cmd_uninstall(args: argparse.Namespace) -> int:
+    print("Uninstall removes MCP entries named 'lbrain' that this installer wrote.")
+    print("It does not delete your brain (~/.lbrain or LBRAIN_HOME).")
+    print("Manual for now: restore *.lbrain-backup next to each config,")
+    print("or delete the lbrain key from mcpServers / [mcp_servers.lbrain].")
+    print(f"Staged runtime (safe to delete): {runtime_dir()}")
+    if args.harness:
+        print("Targeted uninstall of named harnesses is not implemented in 0.1.0.")
+    return 0
+
+
+def cmd_wrap_help(_: argparse.Namespace) -> int:
+    print(
+        """Two-line wrap (OpenAI-compatible client):
+
+    from openai import OpenAI
+    from lbrain_agents.wrap import wrap_openai
+
+    client = wrap_openai(OpenAI(), home="~/.lbrain")
+    # Every chat.completions.create recalls LBrain first.
+    # If nothing binds, the model is told to abstain.
+
+Requires `lbrain` on PATH. Does not write memory unless remember=True.
+"""
+    )
+    return 0
+
+
+def build_parser() -> argparse.ArgumentParser:
+    p = argparse.ArgumentParser(
+        prog="lbrain-agents",
+        description="Install LBrain into coding agents (MCP + skill + session-start).",
+    )
+    sub = p.add_subparsers(dest="cmd", required=True)
+
+    st = sub.add_parser("status", help="Show detected harnesses and lbrain binary")
+    st.set_defaults(func=cmd_status)
+
+    ins = sub.add_parser("install", help="Wire LBrain into one or more harnesses")
+    ins.add_argument(
+        "harness",
+        nargs="*",
+        help="Harness names, or 'all'. Omit to list detections and do nothing.",
+    )
+    ins.add_argument("--home", help="LBRAIN_HOME to export into MCP env")
+    ins.add_argument("--persona", help="LBRAIN_PERSONA to export into MCP env")
+    ins.add_argument("--dry-run", action="store_true")
+    ins.add_argument(
+        "--force",
+        action="store_true",
+        help="Overwrite an existing lbrain MCP entry (does not overwrite other servers).",
+    )
+    ins.add_argument(
+        "--force-absent",
+        action="store_true",
+        help="Install even if the harness is not detected.",
+    )
+    ins.set_defaults(func=cmd_install)
+
+    un = sub.add_parser("uninstall", help="How to remove installer wiring")
+    un.add_argument("harness", nargs="*")
+    un.set_defaults(func=cmd_uninstall)
+
+    wh = sub.add_parser("wrap-help", help="Show the two-line OpenAI wrap")
+    wh.set_defaults(func=cmd_wrap_help)
+    return p
+
+
+def main(argv: Optional[List[str]] = None) -> int:
+    args = build_parser().parse_args(argv)
+    return int(args.func(args))
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())