will.anderson 2f84e2a1de
Neuron Soul CI / build (pull_request) Has been cancelled
Neuron Soul CI / deploy (pull_request) Has been cancelled
Merge remote-tracking branch 'origin/pr/154' into HEAD
# Conflicts:
#	memory.elh
#	neuron-api.elh
#	routes.elh
#	safety.elh
#	sessions.elh
#	soul.elh
2026-08-15 18:50:57 -05:00

neuron

The canonical CGI substrate: the soul (the running agent), the engram (its memory graph), and the MCP proxy/wrapper that expose it. See AGENTS.md for detail, including the audit-verified local build/regenerate recipe and known local-build gotchas.

Quick local build

# 1. dist/soul.c must match current .el sources — this refuses otherwise:
bash tools/build-soul-from-dist.sh dist/neuron

# 2. If it refuses (stale amalgam), regenerate first — see AGENTS.md's
#    "Build / regenerate dist/soul.c" section for the full, gotcha-laden recipe.

For a full local dev stack (soul + engram + mcp-wrapper + mcp-proxy, wired into Claude Code) see neuron-dev-setup/README.md instead — this repo alone only builds the soul.

Code vs. Artifact

  • Authored source: *.el + *.elh at the repo root plus cli/, council/, connectd/, mcp-proxy/, mcp-wrapper/ — edit here.
  • Artifacts (do not hand-edit): dist/soul.c (generated single-TU amalgam — regenerate via the recipe in AGENTS.md, then tools/soulc-stamp.sh --write) and the dist/neuron binary it compiles to.
  • Release: git tag neuron-vX.Y.Z on this repo. No releases/ folders.

See org policy: docs/CODE-VS-ARTIFACT.md.

S
Description
Neuron - the canonical CGI substrate. Real soul.el lives here.
Readme
15 MiB
Languages
Emacs Lisp 68.6%
Python 15.5%
Shell 14.6%
HTML 0.6%
Go Template 0.4%
Other 0.3%