neuron-technologies/neuron
2
0
Fork 0
Code Issues 22 Pull Requests 4 Actions Packages Projects Releases Wiki Activity

Add neuron-dev-setup: one-command CORE dev stack onboarding installer #84

Open
will.anderson wants to merge 1 commits from feat/neuron-dev-setup into main
pull from: feat/neuron-dev-setup
merge into: :main
Conversation 0 Commits 1 Files Changed 15
+1162
will.anderson commented 2026-07-18 18:43:11 +00:00
Owner
Copy Link
Copy Source

Scaffolds neuron-dev-setup/ — a self-contained, idempotent installer that stands up the Neuron CORE dev stack on a fresh Mac so a new dev (Tim) gets an identical Neuron brain + agent to build against.

What it stands up (native launchd core stack)

soul (:7770) → engram (:8742); mcp-wrapper (:17779) → soul; mcp-proxy (:7779) ← Claude Code.

Contents

  • install.sh (POSIX bash, set -euo pipefail, idempotent, 8 phases, --dry-run)
  • uninstall.sh (data-safe by default; --purge-data opt-in)
  • config.env.example, README.md
  • templates/: 4 core LaunchAgent plists, soul-wrapper.sh, Claude config (neuron agent + core hooks + local MCP registration)

Safety / scope

  • Fully templated to $HOME — no hardcoded /Users/will (verified).
  • No secrets committed (verified scan). Anthropic key is prompted for and stored in the macOS Keychain; engram uses a loopback-only dev token.
  • Excluded (personal / non-core): catalyst, telegram, vessels, studio, self-review, world-integrator, council, compressor, snapshots, act-runner, keymap, invest, the disabled :7771 api. Also excluded: check-active-contexts.sh and require-execution-context.sh hooks — they depend on the filesystem synapse repo and the latter would block a fresh dev from editing any file.
  • Nothing was executed; no live service touched. Validated via bash -n, --dry-run, and plutil -lint on rendered templates.

Open questions (in README)

El toolchain acquisition (GCP Artifact Registry access), exact elc flags for engram/wrapper/proxy, forge install ID-preservation for the fixed kn- identity nodes, canonical engram repo, and final home for the bundle (recommend a dedicated repo, not neuron-code which is a real product).

Scaffolds `neuron-dev-setup/` — a self-contained, idempotent installer that stands up the Neuron **CORE** dev stack on a fresh Mac so a new dev (Tim) gets an identical Neuron brain + agent to build against. ## What it stands up (native launchd core stack) soul (:7770) → engram (:8742); mcp-wrapper (:17779) → soul; mcp-proxy (:7779) ← Claude Code. ## Contents - `install.sh` (POSIX bash, `set -euo pipefail`, idempotent, 8 phases, `--dry-run`) - `uninstall.sh` (data-safe by default; `--purge-data` opt-in) - `config.env.example`, `README.md` - `templates/`: 4 core LaunchAgent plists, soul-wrapper.sh, Claude config (neuron agent + core hooks + local MCP registration) ## Safety / scope - Fully **templated to $HOME** — no hardcoded `/Users/will` (verified). - **No secrets committed** (verified scan). Anthropic key is prompted for and stored in the macOS Keychain; engram uses a loopback-only dev token. - **Excluded** (personal / non-core): catalyst, telegram, vessels, studio, self-review, world-integrator, council, compressor, snapshots, act-runner, keymap, invest, the disabled `:7771` api. Also excluded: `check-active-contexts.sh` and `require-execution-context.sh` hooks — they depend on the filesystem `synapse` repo and the latter would block a fresh dev from editing any file. - Nothing was executed; no live service touched. Validated via `bash -n`, `--dry-run`, and `plutil -lint` on rendered templates. ## Open questions (in README) El toolchain acquisition (GCP Artifact Registry access), exact `elc` flags for engram/wrapper/proxy, `forge install` ID-preservation for the fixed `kn-` identity nodes, canonical engram repo, and final home for the bundle (recommend a dedicated repo, **not** neuron-code which is a real product).
will.anderson added 1 commit 2026-07-18 18:43:16 +00:00
Add neuron-dev-setup: one-command CORE dev stack onboarding installer
Neuron Soul CI / build (pull_request) Failing after 14m49s
Details
Neuron Soul CI / deploy (pull_request) Has been skipped
Details
4b24368be2 
Scaffolds a reproducible, idempotent installer that stands up the four native
launchd core services (soul :7770, engram :8742, mcp-wrapper :17779,
mcp-proxy :7779), seeds a fresh engram with the genesis identity via forge, and
installs the Claude Code config (neuron agent + core hooks + local MCP). Fully
templated to the invoking user's $HOME; Anthropic key prompted and stored in
Keychain; no secrets committed. Personal automations and synapse-dependent hooks
excluded from core.
Some required checks failed
Neuron Soul CI / build (pull_request) Failing after 14m49s
Details
Neuron Soul CI / deploy (pull_request) Has been skipped
Details
You are not authorized to merge this pull request.
This pull request can be merged automatically.
This branch is out-of-date with the base branch
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin feat/neuron-dev-setup:feat/neuron-dev-setup
git checkout feat/neuron-dev-setup
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
tim.lingo (Tim Lingo) will.anderson (Will Anderson)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: neuron-technologies/neuron#84
Delete Branch "feat/neuron-dev-setup"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?