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

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

Merged
will.anderson merged 3 commits from feat/neuron-dev-setup into main 2026-07-22 22:33:35 +00:00
Conversation 0 Commits 3 Files Changed 19
+1215 -4
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.
will.anderson added 1 commit 2026-07-22 21:49:34 +00:00
harden(neuron-dev-setup): fix 7 fresh-Mac onboarding installer bugs (#99)
Neuron Soul CI / build (pull_request) Has been cancelled
Details
Neuron Soul CI / deploy (pull_request) Has been cancelled
Details
3ae07cc7b0 
Co-authored-by: Neuron <will.anderson@neurontechnologies.ai>
Co-committed-by: Neuron <will.anderson@neurontechnologies.ai>
will.anderson added 1 commit 2026-07-22 21:49:55 +00:00
Merge remote-tracking branch 'origin/main' into feat/neuron-dev-setup
Neuron Soul CI / build (pull_request) Successful in 4m13s
Details
Neuron Soul CI / deploy (pull_request) Has been skipped
Details
acbe858995
will.anderson merged commit 3d74472a4c into main 2026-07-22 22:33:35 +00:00
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
andre.almeida (Andre Almeida) 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?