diff --git a/.github/workflows/docs-lint.yml b/.github/workflows/docs-lint.yml new file mode 100644 index 0000000..5945a9d --- /dev/null +++ b/.github/workflows/docs-lint.yml @@ -0,0 +1,28 @@ +name: Validate Plugin + +on: + pull_request: + push: + branches: [main] + +jobs: + validate: + runs-on: ubuntu-latest + permissions: + contents: read + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-python@v5 + with: + python-version: "3.11" + - uses: actions/setup-node@v4 + with: + node-version: "22" + - name: Install test runner + run: python -m pip install --disable-pip-version-check pytest + - name: Run supported test suite + run: python -m pytest -q + - name: Run hook unit tests + run: node --test tests/hooks.test.js + - name: Validate plugin documentation + run: ./scripts/doc-lint.sh diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..0fe36e0 --- /dev/null +++ b/.gitignore @@ -0,0 +1,6 @@ +plans/ +.opencode/compact-context.md +node_modules/ +__pycache__/ +.pytest_cache/ +.DS_Store diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..f6fa162 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,54 @@ +# Neural OpenCode project instructions + +## Product boundary + +Neural OpenCode is one installable OpenCode plugin. Its supported surface is +exactly five skills: `discover`, `spec`, `craft`, `vet`, and `exercise`, plus +the reviewed hooks under `plugins/neural-open-code/hooks/`. + +Do not add a second skill root, a silent config writer, or an installer that +copies files into a user's home directory. The plugin package plus documented +`opencode.json` keys are the distribution contract. + +OpenCode 1.18.31 has no marketplace API and no `hooks.json`. Do not invent +Codex `.codex-plugin` paths or Claude `settings.json` merges. + +## Canonical paths + +- Plugin package: `plugins/neural-open-code/package.json` +- Plugin entry: `plugins/neural-open-code/index.js` +- Skills: `plugins/neural-open-code/skills//SKILL.md` +- Hooks: `plugins/neural-open-code/hooks/` +- Example config: `opencode.example.json` +- Public docs: `docs/` +- Plans and evidence: `plans/` +- Unsupported 1.9.0 surface: `archived/v1.9.0/` + +## Change workflow + +Use `/discover` for material ambiguity, `/spec` before non-trivial +implementation, `/craft` for an approved plan, and independent `/vet` plus +`/exercise` gates before shipping. Keep generated evidence beside its plan. + +Never auto-trust hooks or mutate a user's global OpenCode configuration. Never +commit credentials or read/write `.env` contents as part of validation. + +## Required validation + +```bash +python3 -m pytest -q +node --test tests/hooks.test.js +./scripts/doc-lint.sh +``` + +A valid directory shape is necessary but not sufficient: tests must also reject +stale claims and unsupported inventory. + +## Documentation map + +- Architecture: `ARCHITECTURE.md` +- Harness contract: `docs/AGENT-HARNESS.md` +- Workflow: `docs/WORKFLOW.md` +- Hooks and trust: `docs/HOOKS.md` +- Model availability and prompting: `docs/CONFIGURATION.md` +- Verification: `docs/VERIFICATION.md` diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md new file mode 100644 index 0000000..411721b --- /dev/null +++ b/ARCHITECTURE.md @@ -0,0 +1,67 @@ +# Neural OpenCode architecture + +Neural OpenCode has two layers: one plugin package and documented project +config keys. This mirrors OpenCode 1.18.31's distribution model (npm/file +plugins + disk skills) and keeps authoring, installation, and runtime paths +unambiguous. + +```text +repository +├── opencode.json +├── opencode.example.json +└── plugins/neural-open-code + ├── package.json + ├── index.js + ├── skills + │ ├── discover + │ ├── spec + │ ├── craft + │ ├── vet + │ └── exercise + └── hooks + └── *.js +``` + +## Why this is not a Codex marketplace + +OpenCode 1.18.31 has no plugin marketplace, no `plugin.json` skill manifest, +and no `hooks.json`. Plugins are TypeScript/JavaScript modules that return a +`Hooks` object. Skills are `SKILL.md` trees discovered from `.opencode/skills` +or `skills.paths`. Neural OpenCode therefore ships one package and asks the +user to add two explicit keys. + +## Plugin boundary + +`package.json` identifies the package (`name`, `exports["./server"]`, +`engines.opencode`). The entry registers only lifecycle hooks. It does not +declare MCP servers, models, permissions, or agents. + +## Workflow boundary + +The five skills have intentionally different authority: + +1. `/discover` gathers unknowns and stops. +2. `/spec` writes an approvable contract and stops. +3. `/craft` implements only an approved contract. +4. `/vet` evaluates in fresh context and returns `SHIP` or `HOLD`. +5. `/exercise` runs tests and drives observable user behavior. + +No skill silently collapses planning, implementation, review, and exercise into +one self-certifying step. + +## Hook boundary + +Hooks implement OpenCode events: + +- `tool.execute.before` — inspect `bash`, `write`, `edit`, and `apply_patch` +- `tool.execute.after` — scan tool output +- `experimental.session.compacting` — write a recovery note + +They throw to block. They do not call the `config` hook. They complement +OpenCode permission policy; they do not replace it. + +## Configuration boundary + +The plugin never changes model, approval, sandbox, network, MCP, or global +configuration. `docs/CONFIGURATION.md` contains examples only, which keeps +installation reversible and policy-neutral. diff --git a/CHANGELOG.md b/CHANGELOG.md index 760e667..a0a0541 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,53 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 --- +## [2.0.0] - 2026-09-19 + +### Breaking cleanup: Neural Codex port for OpenCode 1.18.31 + +Neural OpenCode is now a lightweight evidence-gated harness, not the 1.9.0 +kitchen sink. Host target is OpenCode **v1.18.31** (there is no OpenCode +v2.0.8). + +### Added + +- Five workflow skills with Neural Codex contracts: `/discover`, `/spec`, + `/craft`, `/vet`, `/exercise` +- OpenCode-native plugin at `plugins/neural-open-code/` (`package.json` + + `index.js` hooks) +- Guardrail hooks on `tool.execute.before`, `tool.execute.after`, and + `experimental.session.compacting` +- Focused docs, GitHub Page sources, and contract tests +- `archived/v1.9.0/` holding the previous product surface as unsupported + +### Removed from the supported product path + +- Agentic course (`/course`) and lesson pack +- Neural Squad (`/squad-*`) +- Neural loops (`/loop` and archived loop commands) +- TTS / ElevenLabs +- Multi-AI mesh (`/pv-mesh`, `/ai-collab`, dedicated Codex/Gemini agents) +- KPI, Compute Advantage, and cost trackers +- Memory / expertise / remember-recall product +- Skills manager, onboard tour, and extra command/agent packs +- Custom `install.sh` / one-liner home-directory installers +- Output styles, status lines, expertise schemas, and CRAFT templates as + first-class surface + +Lyft, WordPress, and MCP-dependent features remain deferred. + +### Migration + +1. Install OpenCode 1.18.31 or later. +2. Add the two documented keys from `opencode.example.json` to your project. +3. Stop using archived 1.9.0 commands and skills. +4. Review `plugins/neural-open-code/hooks/` before trusting a session. + +No GitHub release, npm publish, or live Pages deploy is performed by this +change. + +--- + ## [1.9.0] - 2026-02-03 ### Interactive Agentic Coding Course diff --git a/README.md b/README.md index e411142..9772ed1 100644 --- a/README.md +++ b/README.md @@ -1,175 +1,129 @@ # Neural OpenCode -

- OpenCode Plugin - MIT License - Version -

+Neural OpenCode is a small, evidence-gated workflow for [OpenCode](https://opencode.ai) **1.18.31+**: -

- OpenCode that learns and improves from every interaction. -

- -

- curl -fsSL https://raw.githubusercontent.com/brolag/neural-open-code/main/install.sh | bash -

- ---- - -## The Problem - -Every OpenCode session starts from zero. You explain your project structure, conventions, and preferences... again and again. - -## The Solution - -Neural OpenCode remembers. It learns patterns, accumulates knowledge, and gets smarter over time. - -``` -Traditional: Execute -> Forget -> Repeat forever -Neural: Execute -> Learn -> Improve always +```text +discover -> spec -> craft -> vet -> exercise ``` ---- +It is distributed as one OpenCode plugin. The repository intentionally ships +only those five skills and the reviewed lifecycle hooks that support them. -## Quick Start +## Install -**One command to install:** +Requires [OpenCode](https://opencode.ai) **v1.18.31** or later (`opencode --version`). -```bash -curl -fsSL https://raw.githubusercontent.com/brolag/neural-open-code/main/install.sh | bash +Clone this repository, then add the plugin and skill path to **your project's** +`opencode.json`. The plugin does not edit global OpenCode config, model +selection, approval policy, sandbox settings, or MCP servers. + +```json +{ + "$schema": "https://opencode.ai/config.json", + "plugin": ["./plugins/neural-open-code"], + "skills": { + "paths": ["./plugins/neural-open-code/skills"] + } +} ``` -The installer will: -- Clone the repository -- Configure your shell -- Register all commands -- Set up hooks -- Offer to install recommended skills +If this repository lives outside the project, use an absolute path or a +`file://` URL instead of `./plugins/neural-open-code`. A copy-paste example is +in [`opencode.example.json`](opencode.example.json). -**Then run the guided tour:** +Restart OpenCode after changing project config. Confirm the plugin loaded and +review the hook source before trusting it in a session: ```bash -/onboard +opencode --version +ls plugins/neural-open-code/hooks ``` -
-Manual installation +Installing or enabling the plugin does not trust hooks automatically. OpenCode +1.18.31 has no `/hooks` trust UI; read `plugins/neural-open-code/hooks/` and +keep the plugin entry only if it matches your policy. Remove those two +`opencode.json` keys to uninstall. -```bash -# 1. Clone -git clone https://github.com/brolag/neural-open-code ~/Sites/neural-open-code +## Workflow -# 2. Setup -cd ~/Sites/neural-open-code && ./scripts/setup-hooks.sh +| Skill | Purpose | Artifact or verdict | +|---|---|---| +| `/discover` | Surface architectural unknowns before planning | `unknowns-map.md` | +| `/spec` | Lock interfaces, invariants, dependencies, and acceptance | `plan.md` | +| `/craft` | Build an approved plan and capture before/after evidence | implemented change | +| `/vet` | Review the change independently and adversarially | `SHIP` or `HOLD` | +| `/exercise` | Drive the result as a user after automated tests | `PASS` or `FAIL` | -# 3. Add to shell -echo 'export OPENCODE_PLUGIN_ROOT="$HOME/Sites/neural-open-code"' >> ~/.zshrc -source ~/.zshrc +Small, obvious edits can skip `/discover` and sometimes `/spec`. Material work +should preserve the gates: planning does not implement, implementation does not +self-approve, and green tests do not replace behavioral verification. -# 4. Guided tour -/onboard -``` +See [the workflow guide](docs/WORKFLOW.md) for artifact contracts and examples. -
+## Hooks -**[Full Installation Guide ->](docs/tutorials/01-installation.md)** +The plugin includes dependency-free Node hooks for: ---- +- blocking high-confidence destructive shell commands; +- guarding common secret-bearing files from writes; +- detecting obvious instruction injection in executable content; +- warning when tool output resembles credentials; +- preserving a compact recovery note before context compaction. -## Key Features +Hooks are guardrails, not a sandbox. Review their limits and trust model in +[docs/HOOKS.md](docs/HOOKS.md). -| Feature | What it does | Command | -|---------|--------------|---------| -| **Agentic Course** | Interactive 13-lesson course for mastering agentic coding | `/course` | -| **Neural Squad** | Multi-agent orchestration with anti-slop enforcement | `/squad-init`, `/squad-status` | -| **CRAFT Framework** | Structured prompts for autonomous agents | `/craft` | -| **KPI Tracking** | Measure Plan/Review Velocity, Autonomy, Loop State | `/kpi` | -| **Compute Advantage** | Calculate your agentic leverage ratio | `/ca` | -| **Cost Tracking** | Real-time API cost monitoring | `/cost` | -| **Skills Manager** | Install, enable/disable skills on demand | `/install-skills`, `/manage-skills` | -| **Self-Learning** | Expertise files that grow smarter each session | `/remember`, `/recall` | -| **Persistent Memory** | Facts and patterns that survive restarts | `/remember`, `/forget` | -| **Code Quality** | Detect and auto-fix technical debt | `/slop-scan`, `/slop-fix`, `/overseer` | -| **Neural Loops** | Autonomous coding sessions that iterate until done | `/loop` | -| **Multi-AI** | Route tasks to Claude, Codex, or Gemini | `/pv-mesh`, `/ai-collab` | +## Model and prompting guidance ---- +Neural OpenCode does not change `opencode.json` model, agent, permission, MCP, +or sandbox fields beyond the two install keys you add. Model availability +differs by provider and account, so do not hardcode a model ID only because it +appears in a vendor guide. Safe copyable settings are separated in +[docs/CONFIGURATION.md](docs/CONFIGURATION.md). -## Quick Commands +## Repository structure -```bash -# First time? Start here -/onboard # Guided tour -/course # 13-lesson agentic coding course - -# Install and manage skills -/install-skills # Add new skills -/manage-skills # Enable/disable/update -/tts off # Toggle voice/summaries - -# Memory -/remember The API uses JWT tokens -/recall database - -# Development -/debug # Root cause analysis -/tdd # Test-driven development -/slop-scan # Find technical debt -/overseer # Review PR quality - -# Autonomous work -/loop "Fix all tests" --max 10 -/loop "Build feature" --craft # With CRAFT prompt - -# Multi-agent squad -/squad-init # Initialize 3-agent system -/squad-status # Check agents and tasks -/squad-task create "Feature" # Create task for squad -/squad-standup # Daily standup report - -# Agentic metrics -/kpi # Performance dashboard -/ca # Compute Advantage score -/cost # API cost tracking -/craft "Build auth system" # Generate structured prompt - -# Learning -/learn https://github.com/user/repo +```text +opencode.json # this repo's local plugin + skills paths +plugins/neural-open-code/ + package.json # OpenCode 1.18.31 plugin package + index.js # hook registration + skills/ # exactly five workflow skills + hooks/ # tool.execute.* and compacting handlers +docs/ # focused guides and GitHub Page +tests/ # plugin, workflow, hook, and docs contracts +archived/v1.9.0/ # unsupported 1.9.0 kitchen sink ``` -**[All Commands ->](docs/reference/commands.md)** - ---- - -## Learn More +The 2.0 plugin is a deliberate breaking cleanup. Previous command bundles, +personas, autonomous loops, courses, squads, TTS, multi-AI mesh, KPI/CA/cost +trackers, profiles, templates, and custom installers are not part of the +supported product. See [`archived/v1.9.0/UNSUPPORTED.md`](archived/v1.9.0/UNSUPPORTED.md). -| New here? | Know what you want? | -|-----------|---------------------| -| **[Tutorials](docs/tutorials/)** | **[How-to Guides](docs/how-to/)** | -| Step-by-step learning | Task-focused recipes | +## Develop and validate -| Need to look something up? | Want to understand? | -|---------------------------|---------------------| -| **[Reference](docs/reference/)** | **[Explanation](docs/explanation/)** | -| Commands, agents, config | Architecture, patterns | +Requirements: Python 3.11+, `pytest`, and Node.js 20+ (OpenCode's plugin +runtime is Bun; the hook units run on Node). -**[Full Documentation ->](docs/index.md)** - ---- +```bash +python3 -m pytest -q +node --test tests/hooks.test.js +./scripts/doc-lint.sh +``` -## Contributing +The full verification and behavioral expectations are in +[docs/VERIFICATION.md](docs/VERIFICATION.md). -Contributions welcome! [Open an issue](https://github.com/brolag/neural-open-code/issues) or submit a PR. +## Documentation ---- +- [Architecture](ARCHITECTURE.md) +- [Agent harness](docs/AGENT-HARNESS.md) +- [Workflow](docs/WORKFLOW.md) +- [Hooks](docs/HOOKS.md) +- [Configuration](docs/CONFIGURATION.md) +- [Verification](docs/VERIFICATION.md) +- [GitHub Page](https://brolag.github.io/neural-open-code/) ## License -MIT - see [LICENSE](LICENSE) - ---- - -

- Built with OpenCode
- Self-improving AI that learns from you -

+MIT — see [LICENSE](LICENSE) diff --git a/_config.yml b/_config.yml index 61a1d36..8dd3d30 100644 --- a/_config.yml +++ b/_config.yml @@ -1 +1,14 @@ -theme: null +title: Neural OpenCode +description: Five evidence-gated skills for OpenCode 1.18.31 +exclude: + - archived + - plugins + - tests + - scripts + - node_modules + - opencode.json + - opencode.example.json + - AGENTS.md + - ARCHITECTURE.md + - CHANGELOG.md + - LICENSE diff --git a/ONE-LINER-INSTALL.md b/archived/v1.9.0/ONE-LINER-INSTALL.md similarity index 100% rename from ONE-LINER-INSTALL.md rename to archived/v1.9.0/ONE-LINER-INSTALL.md diff --git a/archived/v1.9.0/README.md b/archived/v1.9.0/README.md new file mode 100644 index 0000000..e411142 --- /dev/null +++ b/archived/v1.9.0/README.md @@ -0,0 +1,175 @@ +# Neural OpenCode + +

+ OpenCode Plugin + MIT License + Version +

+ +

+ OpenCode that learns and improves from every interaction. +

+ +

+ curl -fsSL https://raw.githubusercontent.com/brolag/neural-open-code/main/install.sh | bash +

+ +--- + +## The Problem + +Every OpenCode session starts from zero. You explain your project structure, conventions, and preferences... again and again. + +## The Solution + +Neural OpenCode remembers. It learns patterns, accumulates knowledge, and gets smarter over time. + +``` +Traditional: Execute -> Forget -> Repeat forever +Neural: Execute -> Learn -> Improve always +``` + +--- + +## Quick Start + +**One command to install:** + +```bash +curl -fsSL https://raw.githubusercontent.com/brolag/neural-open-code/main/install.sh | bash +``` + +The installer will: +- Clone the repository +- Configure your shell +- Register all commands +- Set up hooks +- Offer to install recommended skills + +**Then run the guided tour:** + +```bash +/onboard +``` + +
+Manual installation + +```bash +# 1. Clone +git clone https://github.com/brolag/neural-open-code ~/Sites/neural-open-code + +# 2. Setup +cd ~/Sites/neural-open-code && ./scripts/setup-hooks.sh + +# 3. Add to shell +echo 'export OPENCODE_PLUGIN_ROOT="$HOME/Sites/neural-open-code"' >> ~/.zshrc +source ~/.zshrc + +# 4. Guided tour +/onboard +``` + +
+ +**[Full Installation Guide ->](docs/tutorials/01-installation.md)** + +--- + +## Key Features + +| Feature | What it does | Command | +|---------|--------------|---------| +| **Agentic Course** | Interactive 13-lesson course for mastering agentic coding | `/course` | +| **Neural Squad** | Multi-agent orchestration with anti-slop enforcement | `/squad-init`, `/squad-status` | +| **CRAFT Framework** | Structured prompts for autonomous agents | `/craft` | +| **KPI Tracking** | Measure Plan/Review Velocity, Autonomy, Loop State | `/kpi` | +| **Compute Advantage** | Calculate your agentic leverage ratio | `/ca` | +| **Cost Tracking** | Real-time API cost monitoring | `/cost` | +| **Skills Manager** | Install, enable/disable skills on demand | `/install-skills`, `/manage-skills` | +| **Self-Learning** | Expertise files that grow smarter each session | `/remember`, `/recall` | +| **Persistent Memory** | Facts and patterns that survive restarts | `/remember`, `/forget` | +| **Code Quality** | Detect and auto-fix technical debt | `/slop-scan`, `/slop-fix`, `/overseer` | +| **Neural Loops** | Autonomous coding sessions that iterate until done | `/loop` | +| **Multi-AI** | Route tasks to Claude, Codex, or Gemini | `/pv-mesh`, `/ai-collab` | + +--- + +## Quick Commands + +```bash +# First time? Start here +/onboard # Guided tour +/course # 13-lesson agentic coding course + +# Install and manage skills +/install-skills # Add new skills +/manage-skills # Enable/disable/update +/tts off # Toggle voice/summaries + +# Memory +/remember The API uses JWT tokens +/recall database + +# Development +/debug # Root cause analysis +/tdd # Test-driven development +/slop-scan # Find technical debt +/overseer # Review PR quality + +# Autonomous work +/loop "Fix all tests" --max 10 +/loop "Build feature" --craft # With CRAFT prompt + +# Multi-agent squad +/squad-init # Initialize 3-agent system +/squad-status # Check agents and tasks +/squad-task create "Feature" # Create task for squad +/squad-standup # Daily standup report + +# Agentic metrics +/kpi # Performance dashboard +/ca # Compute Advantage score +/cost # API cost tracking +/craft "Build auth system" # Generate structured prompt + +# Learning +/learn https://github.com/user/repo +``` + +**[All Commands ->](docs/reference/commands.md)** + +--- + +## Learn More + +| New here? | Know what you want? | +|-----------|---------------------| +| **[Tutorials](docs/tutorials/)** | **[How-to Guides](docs/how-to/)** | +| Step-by-step learning | Task-focused recipes | + +| Need to look something up? | Want to understand? | +|---------------------------|---------------------| +| **[Reference](docs/reference/)** | **[Explanation](docs/explanation/)** | +| Commands, agents, config | Architecture, patterns | + +**[Full Documentation ->](docs/index.md)** + +--- + +## Contributing + +Contributions welcome! [Open an issue](https://github.com/brolag/neural-open-code/issues) or submit a PR. + +--- + +## License + +MIT - see [LICENSE](LICENSE) + +--- + +

+ Built with OpenCode
+ Self-improving AI that learns from you +

diff --git a/RELEASE-v1.4.0.md b/archived/v1.9.0/RELEASE-v1.4.0.md similarity index 100% rename from RELEASE-v1.4.0.md rename to archived/v1.9.0/RELEASE-v1.4.0.md diff --git a/archived/v1.9.0/UNSUPPORTED.md b/archived/v1.9.0/UNSUPPORTED.md new file mode 100644 index 0000000..b9bb6ab --- /dev/null +++ b/archived/v1.9.0/UNSUPPORTED.md @@ -0,0 +1,23 @@ +# Archived Neural OpenCode 1.9.0 surface + +This tree is **unsupported**. It is kept so history remains readable after the +2.0 breaking cleanup. + +Do not present these files as the current product. Do not load +`dot-opencode/` as the supported OpenCode plugin. The supported surface lives +at `plugins/neural-open-code/` on the repository root. + +Removed from the supported path (non-exhaustive): + +- Agentic course (`/course`) +- Neural Squad and related commands +- Neural loops (`/loop`) +- TTS / ElevenLabs +- Multi-AI mesh (`/pv-mesh`, `/ai-collab`) +- KPI, Compute Advantage, and cost trackers +- Memory / expertise / remember-recall product +- Custom installers and one-liner home-directory setup +- Output styles, status lines, and extra command/agent packs + +Lyft, WordPress, and MCP-dependent features were never part of the 2.0 port +and stay deferred. diff --git a/config/bash-permissions.yaml b/archived/v1.9.0/config/bash-permissions.yaml similarity index 100% rename from config/bash-permissions.yaml rename to archived/v1.9.0/config/bash-permissions.yaml diff --git a/config/keybindings.json b/archived/v1.9.0/config/keybindings.json similarity index 100% rename from config/keybindings.json rename to archived/v1.9.0/config/keybindings.json diff --git a/docs/404.html b/archived/v1.9.0/docs/404.html similarity index 100% rename from docs/404.html rename to archived/v1.9.0/docs/404.html diff --git a/docs/CHANGELOG.md b/archived/v1.9.0/docs/CHANGELOG.md similarity index 100% rename from docs/CHANGELOG.md rename to archived/v1.9.0/docs/CHANGELOG.md diff --git a/docs/PATTERNS_v3.1.md b/archived/v1.9.0/docs/PATTERNS_v3.1.md similarity index 100% rename from docs/PATTERNS_v3.1.md rename to archived/v1.9.0/docs/PATTERNS_v3.1.md diff --git a/docs/ROUTING_PLAYBOOK.md b/archived/v1.9.0/docs/ROUTING_PLAYBOOK.md similarity index 100% rename from docs/ROUTING_PLAYBOOK.md rename to archived/v1.9.0/docs/ROUTING_PLAYBOOK.md diff --git a/docs/SETUP.md b/archived/v1.9.0/docs/SETUP.md similarity index 100% rename from docs/SETUP.md rename to archived/v1.9.0/docs/SETUP.md diff --git a/docs/TASK_TOOL_GUIDE.md b/archived/v1.9.0/docs/TASK_TOOL_GUIDE.md similarity index 100% rename from docs/TASK_TOOL_GUIDE.md rename to archived/v1.9.0/docs/TASK_TOOL_GUIDE.md diff --git a/docs/_config.yml b/archived/v1.9.0/docs/_config.yml similarity index 100% rename from docs/_config.yml rename to archived/v1.9.0/docs/_config.yml diff --git a/docs/explanation/agent-expert.md b/archived/v1.9.0/docs/explanation/agent-expert.md similarity index 100% rename from docs/explanation/agent-expert.md rename to archived/v1.9.0/docs/explanation/agent-expert.md diff --git a/docs/explanation/architecture.md b/archived/v1.9.0/docs/explanation/architecture.md similarity index 100% rename from docs/explanation/architecture.md rename to archived/v1.9.0/docs/explanation/architecture.md diff --git a/docs/explanation/multi-ai.md b/archived/v1.9.0/docs/explanation/multi-ai.md similarity index 100% rename from docs/explanation/multi-ai.md rename to archived/v1.9.0/docs/explanation/multi-ai.md diff --git a/docs/explanation/patterns.md b/archived/v1.9.0/docs/explanation/patterns.md similarity index 100% rename from docs/explanation/patterns.md rename to archived/v1.9.0/docs/explanation/patterns.md diff --git a/docs/how-to/memory.md b/archived/v1.9.0/docs/how-to/memory.md similarity index 100% rename from docs/how-to/memory.md rename to archived/v1.9.0/docs/how-to/memory.md diff --git a/docs/how-to/meta-agents.md b/archived/v1.9.0/docs/how-to/meta-agents.md similarity index 100% rename from docs/how-to/meta-agents.md rename to archived/v1.9.0/docs/how-to/meta-agents.md diff --git a/docs/how-to/multi-ai.md b/archived/v1.9.0/docs/how-to/multi-ai.md similarity index 100% rename from docs/how-to/multi-ai.md rename to archived/v1.9.0/docs/how-to/multi-ai.md diff --git a/docs/how-to/neural-loops.md b/archived/v1.9.0/docs/how-to/neural-loops.md similarity index 100% rename from docs/how-to/neural-loops.md rename to archived/v1.9.0/docs/how-to/neural-loops.md diff --git a/docs/how-to/output-styles.md b/archived/v1.9.0/docs/how-to/output-styles.md similarity index 100% rename from docs/how-to/output-styles.md rename to archived/v1.9.0/docs/how-to/output-styles.md diff --git a/docs/how-to/research.md b/archived/v1.9.0/docs/how-to/research.md similarity index 100% rename from docs/how-to/research.md rename to archived/v1.9.0/docs/how-to/research.md diff --git a/archived/v1.9.0/docs/index.html b/archived/v1.9.0/docs/index.html new file mode 100644 index 0000000..1892c33 --- /dev/null +++ b/archived/v1.9.0/docs/index.html @@ -0,0 +1,344 @@ + + + + + + Neural OpenCode - Self-Improving AI Development System + + + + + + + +
+ +
+ +
+ +
+
+
+
v1.5.0
+

Neural OpenCode Plugin

+

OpenCode that learns and improves from every interaction

+

+ Every OpenCode session starts from zero. Neural OpenCode remembers. + It learns patterns, accumulates knowledge, and gets smarter over time. +

+
+ Get Started + View on GitHub +
+
+
+ 10+ + Agents +
+
+ 20+ + Skills +
+
+ 30+ + Commands +
+
+ 3 + AI Models +
+
+
+
+
+
+ + + + One Command Install +
+ 
# Install Neural OpenCode
+curl -fsSL https://raw.githubusercontent.com/
+  brolag/neural-open-code/
+  main/install.sh | bash
+
+# Then run the guided tour
+/onboard
+
+# Traditional vs Neural
+Traditional: Execute -> Forget -> Repeat
+Neural:      Execute -> Learn  -> Improve
+
+
+
+ +
+

Core Features

+
+
+
🎯
+

Skills Manager

+

Install, enable, disable, and update skills on demand. Interactive installer with categories and dependency resolution.

+
+ /install-skills /manage-skills +
+
+
+
🧠
+

Persistent Memory

+

Facts, patterns, and learnings that survive restarts. Hot, warm, and cold memory tiers with global and project-level persistence.

+
+ /remember /recall /forget +
+
+
+
🔍
+

Code Quality

+

Detect technical debt and auto-fix safe issues. Review PRs before merge with the overseer agent.

+
+ /slop-scan /slop-fix /overseer +
+
+
+
🤖
+

Multi-AI Collaboration

+

Orchestrate Claude, Codex, and Gemini with intelligent routing based on task type and benchmarked strengths.

+
+ /ai-collab /pv-mesh /plan-execute +
+
+
+
🔊
+

TTS Control

+

Voice and text summaries with granular control. Toggle audio, text summary, or both independently.

+
+ /tts on /tts audio off /tts summary off +
+
+
+
🔄
+

Neural Loops

+

Autonomous coding sessions that iterate until done. AFK mode, plan-first loops, and typed workflows.

+
+ /loop "Fix all tests" --max 10 +
+
+
+
+ +
+

Specialized Agents

+

Each agent maintains expertise that evolves through usage

+
+
+
+ 🏗️ +

meta-agent

+
+

Creates new agents dynamically based on patterns and requests

+
+
+
+ 🧠 +

cognitive-amplifier

+
+

Enhanced thinking, bias detection, multi-perspective analysis

+
+
+
+ 💡 +

insight-synthesizer

+
+

Cross-domain pattern discovery and breakthrough thinking

+
+
+
+ 🔍 +

overseer

+
+

Review PRs and diffs for quality, security, and best practices

+
+
+
+ 🤝 +

multi-ai

+
+

Orchestrates Claude, Codex, and Gemini for complex problems

+
+ Claude 80.9% + Codex #1 + Gemini 1501 +
+
+
+
+ 🚀 +

optimizer

+
+

Performance tuning and system optimization specialist

+
+
+
+ +
+

Multi-AI Intelligence

+
+ + + + + + + + + + + + + + + + + + + + + + + + + +
AI ModelBenchmarkBest For
Claude Opus 4.580.9% SWE-benchArchitecture, accuracy, code quality
GPT-5.1-Codex-MaxTerminal-Bench #1DevOps, CLI tasks, 7+ hour sessions
Gemini 3 Pro1501 Elo LMArenaAlgorithms, competitive coding
+
+
+ +
+

Installation

+
+
+
1
+
+

One Command Install

+
+ curl -fsSL https://raw.githubusercontent.com/brolag/neural-open-code/main/install.sh | bash +
+

Clones repo, configures shell, registers commands, sets up hooks, and offers skill installation.

+
+
+
+
2
+
+

Run the Guided Tour

+
+ /onboard +
+

Interactive 7-step tour: system check, feature discovery, skills setup, TTS config, and command reference.

+
+
+
+
3
+
+

Start Building

+
+ /remember My API uses JWT tokens + /loop "Fix all tests" --max 10 +
+
+
+
+
+

Requirements

+
+
+ ✓ + OpenCode CLI +
+
+ ✓ + Git +
+
+ ○ + jq (recommended) +
+
+ ○ + ElevenLabs API (TTS) +
+
+
+
+ +
+

Quick Commands

+
+
+ /onboard + Interactive guided tour +
+
+ /install-skills + Add new skills +
+
+ /manage-skills + Enable/disable skills +
+
+ /slop-scan + Detect technical debt +
+
+ /overseer + Review PR quality +
+
+ /loop "task" + Autonomous coding +
+
+ /remember <fact> + Save to memory +
+
+ /ai-collab <problem> + Multi-AI consensus +
+
+
+ +
+

Ready to supercharge your development?

+

One command. Persistent memory. Self-improving AI.

+
+ + Get Started on GitHub + +
+
+
+ + + + diff --git a/docs/index.md b/archived/v1.9.0/docs/index.md similarity index 100% rename from docs/index.md rename to archived/v1.9.0/docs/index.md diff --git a/docs/neural-squad.md b/archived/v1.9.0/docs/neural-squad.md similarity index 100% rename from docs/neural-squad.md rename to archived/v1.9.0/docs/neural-squad.md diff --git a/docs/reference/agents.md b/archived/v1.9.0/docs/reference/agents.md similarity index 100% rename from docs/reference/agents.md rename to archived/v1.9.0/docs/reference/agents.md diff --git a/docs/reference/commands.md b/archived/v1.9.0/docs/reference/commands.md similarity index 100% rename from docs/reference/commands.md rename to archived/v1.9.0/docs/reference/commands.md diff --git a/docs/reference/config.md b/archived/v1.9.0/docs/reference/config.md similarity index 100% rename from docs/reference/config.md rename to archived/v1.9.0/docs/reference/config.md diff --git a/docs/reference/project-structure.md b/archived/v1.9.0/docs/reference/project-structure.md similarity index 100% rename from docs/reference/project-structure.md rename to archived/v1.9.0/docs/reference/project-structure.md diff --git a/docs/reference/skills.md b/archived/v1.9.0/docs/reference/skills.md similarity index 100% rename from docs/reference/skills.md rename to archived/v1.9.0/docs/reference/skills.md diff --git a/docs/style.css b/archived/v1.9.0/docs/style.css similarity index 100% rename from docs/style.css rename to archived/v1.9.0/docs/style.css diff --git a/docs/tutorials/01-installation.md b/archived/v1.9.0/docs/tutorials/01-installation.md similarity index 100% rename from docs/tutorials/01-installation.md rename to archived/v1.9.0/docs/tutorials/01-installation.md diff --git a/docs/tutorials/02-first-expertise.md b/archived/v1.9.0/docs/tutorials/02-first-expertise.md similarity index 100% rename from docs/tutorials/02-first-expertise.md rename to archived/v1.9.0/docs/tutorials/02-first-expertise.md diff --git a/docs/tutorials/03-first-loop.md b/archived/v1.9.0/docs/tutorials/03-first-loop.md similarity index 100% rename from docs/tutorials/03-first-loop.md rename to archived/v1.9.0/docs/tutorials/03-first-loop.md diff --git a/.opencode/agents/archived/framework-architect.md b/archived/v1.9.0/dot-opencode/agents/archived/framework-architect.md similarity index 100% rename from .opencode/agents/archived/framework-architect.md rename to archived/v1.9.0/dot-opencode/agents/archived/framework-architect.md diff --git a/.opencode/agents/archived/insight-synthesizer.md b/archived/v1.9.0/dot-opencode/agents/archived/insight-synthesizer.md similarity index 100% rename from .opencode/agents/archived/insight-synthesizer.md rename to archived/v1.9.0/dot-opencode/agents/archived/insight-synthesizer.md diff --git a/.opencode/agents/archived/meta-agent.md b/archived/v1.9.0/dot-opencode/agents/archived/meta-agent.md similarity index 100% rename from .opencode/agents/archived/meta-agent.md rename to archived/v1.9.0/dot-opencode/agents/archived/meta-agent.md diff --git a/.opencode/agents/archived/meta-architect.md b/archived/v1.9.0/dot-opencode/agents/archived/meta-architect.md similarity index 100% rename from .opencode/agents/archived/meta-architect.md rename to archived/v1.9.0/dot-opencode/agents/archived/meta-architect.md diff --git a/.opencode/agents/code-reviewer.md b/archived/v1.9.0/dot-opencode/agents/code-reviewer.md similarity index 100% rename from .opencode/agents/code-reviewer.md rename to archived/v1.9.0/dot-opencode/agents/code-reviewer.md diff --git a/.opencode/agents/codex.md b/archived/v1.9.0/dot-opencode/agents/codex.md similarity index 100% rename from .opencode/agents/codex.md rename to archived/v1.9.0/dot-opencode/agents/codex.md diff --git a/.opencode/agents/cognitive-amplifier.md b/archived/v1.9.0/dot-opencode/agents/cognitive-amplifier.md similarity index 100% rename from .opencode/agents/cognitive-amplifier.md rename to archived/v1.9.0/dot-opencode/agents/cognitive-amplifier.md diff --git a/.opencode/agents/dispatcher.md b/archived/v1.9.0/dot-opencode/agents/dispatcher.md similarity index 100% rename from .opencode/agents/dispatcher.md rename to archived/v1.9.0/dot-opencode/agents/dispatcher.md diff --git a/.opencode/agents/gemini.md b/archived/v1.9.0/dot-opencode/agents/gemini.md similarity index 100% rename from .opencode/agents/gemini.md rename to archived/v1.9.0/dot-opencode/agents/gemini.md diff --git a/.opencode/agents/multi-ai.md b/archived/v1.9.0/dot-opencode/agents/multi-ai.md similarity index 100% rename from .opencode/agents/multi-ai.md rename to archived/v1.9.0/dot-opencode/agents/multi-ai.md diff --git a/.opencode/agents/optimizer.md b/archived/v1.9.0/dot-opencode/agents/optimizer.md similarity index 100% rename from .opencode/agents/optimizer.md rename to archived/v1.9.0/dot-opencode/agents/optimizer.md diff --git a/.opencode/commands/archived/gh-learn.md b/archived/v1.9.0/dot-opencode/commands/archived/gh-learn.md similarity index 100% rename from .opencode/commands/archived/gh-learn.md rename to archived/v1.9.0/dot-opencode/commands/archived/gh-learn.md diff --git a/.opencode/commands/archived/loop-cancel.md b/archived/v1.9.0/dot-opencode/commands/archived/loop-cancel.md similarity index 100% rename from .opencode/commands/archived/loop-cancel.md rename to archived/v1.9.0/dot-opencode/commands/archived/loop-cancel.md diff --git a/.opencode/commands/archived/loop-coverage.md b/archived/v1.9.0/dot-opencode/commands/archived/loop-coverage.md similarity index 100% rename from .opencode/commands/archived/loop-coverage.md rename to archived/v1.9.0/dot-opencode/commands/archived/loop-coverage.md diff --git a/.opencode/commands/archived/loop-entropy.md b/archived/v1.9.0/dot-opencode/commands/archived/loop-entropy.md similarity index 100% rename from .opencode/commands/archived/loop-entropy.md rename to archived/v1.9.0/dot-opencode/commands/archived/loop-entropy.md diff --git a/.opencode/commands/archived/loop-init.md b/archived/v1.9.0/dot-opencode/commands/archived/loop-init.md similarity index 100% rename from .opencode/commands/archived/loop-init.md rename to archived/v1.9.0/dot-opencode/commands/archived/loop-init.md diff --git a/.opencode/commands/archived/loop-lint.md b/archived/v1.9.0/dot-opencode/commands/archived/loop-lint.md similarity index 100% rename from .opencode/commands/archived/loop-lint.md rename to archived/v1.9.0/dot-opencode/commands/archived/loop-lint.md diff --git a/.opencode/commands/archived/loop-plan.md b/archived/v1.9.0/dot-opencode/commands/archived/loop-plan.md similarity index 100% rename from .opencode/commands/archived/loop-plan.md rename to archived/v1.9.0/dot-opencode/commands/archived/loop-plan.md diff --git a/.opencode/commands/archived/loop-start.md b/archived/v1.9.0/dot-opencode/commands/archived/loop-start.md similarity index 100% rename from .opencode/commands/archived/loop-start.md rename to archived/v1.9.0/dot-opencode/commands/archived/loop-start.md diff --git a/.opencode/commands/archived/loop-status.md b/archived/v1.9.0/dot-opencode/commands/archived/loop-status.md similarity index 100% rename from .opencode/commands/archived/loop-status.md rename to archived/v1.9.0/dot-opencode/commands/archived/loop-status.md diff --git a/.opencode/commands/archived/output-style.md b/archived/v1.9.0/dot-opencode/commands/archived/output-style.md similarity index 100% rename from .opencode/commands/archived/output-style.md rename to archived/v1.9.0/dot-opencode/commands/archived/output-style.md diff --git a/.opencode/commands/archived/pdf-learn.md b/archived/v1.9.0/dot-opencode/commands/archived/pdf-learn.md similarity index 100% rename from .opencode/commands/archived/pdf-learn.md rename to archived/v1.9.0/dot-opencode/commands/archived/pdf-learn.md diff --git a/.opencode/commands/archived/ralph.md b/archived/v1.9.0/dot-opencode/commands/archived/ralph.md similarity index 100% rename from .opencode/commands/archived/ralph.md rename to archived/v1.9.0/dot-opencode/commands/archived/ralph.md diff --git a/.opencode/commands/archived/sync.md b/archived/v1.9.0/dot-opencode/commands/archived/sync.md similarity index 100% rename from .opencode/commands/archived/sync.md rename to archived/v1.9.0/dot-opencode/commands/archived/sync.md diff --git a/.opencode/commands/archived/yt-learn.md b/archived/v1.9.0/dot-opencode/commands/archived/yt-learn.md similarity index 100% rename from .opencode/commands/archived/yt-learn.md rename to archived/v1.9.0/dot-opencode/commands/archived/yt-learn.md diff --git a/.opencode/commands/changelog-architect.md b/archived/v1.9.0/dot-opencode/commands/changelog-architect.md similarity index 100% rename from .opencode/commands/changelog-architect.md rename to archived/v1.9.0/dot-opencode/commands/changelog-architect.md diff --git a/.opencode/commands/course.md b/archived/v1.9.0/dot-opencode/commands/course.md similarity index 100% rename from .opencode/commands/course.md rename to archived/v1.9.0/dot-opencode/commands/course.md diff --git a/.opencode/commands/craft.md b/archived/v1.9.0/dot-opencode/commands/craft.md similarity index 100% rename from .opencode/commands/craft.md rename to archived/v1.9.0/dot-opencode/commands/craft.md diff --git a/.opencode/commands/evolve.md b/archived/v1.9.0/dot-opencode/commands/evolve.md similarity index 100% rename from .opencode/commands/evolve.md rename to archived/v1.9.0/dot-opencode/commands/evolve.md diff --git a/.opencode/commands/install-skills.md b/archived/v1.9.0/dot-opencode/commands/install-skills.md similarity index 100% rename from .opencode/commands/install-skills.md rename to archived/v1.9.0/dot-opencode/commands/install-skills.md diff --git a/.opencode/commands/loop.md b/archived/v1.9.0/dot-opencode/commands/loop.md similarity index 100% rename from .opencode/commands/loop.md rename to archived/v1.9.0/dot-opencode/commands/loop.md diff --git a/.opencode/commands/manage-skills.md b/archived/v1.9.0/dot-opencode/commands/manage-skills.md similarity index 100% rename from .opencode/commands/manage-skills.md rename to archived/v1.9.0/dot-opencode/commands/manage-skills.md diff --git a/.opencode/commands/meta/agent.md b/archived/v1.9.0/dot-opencode/commands/meta/agent.md similarity index 100% rename from .opencode/commands/meta/agent.md rename to archived/v1.9.0/dot-opencode/commands/meta/agent.md diff --git a/.opencode/commands/meta/brain.md b/archived/v1.9.0/dot-opencode/commands/meta/brain.md similarity index 100% rename from .opencode/commands/meta/brain.md rename to archived/v1.9.0/dot-opencode/commands/meta/brain.md diff --git a/.opencode/commands/meta/eval.md b/archived/v1.9.0/dot-opencode/commands/meta/eval.md similarity index 100% rename from .opencode/commands/meta/eval.md rename to archived/v1.9.0/dot-opencode/commands/meta/eval.md diff --git a/.opencode/commands/meta/improve.md b/archived/v1.9.0/dot-opencode/commands/meta/improve.md similarity index 100% rename from .opencode/commands/meta/improve.md rename to archived/v1.9.0/dot-opencode/commands/meta/improve.md diff --git a/.opencode/commands/meta/prompt.md b/archived/v1.9.0/dot-opencode/commands/meta/prompt.md similarity index 100% rename from .opencode/commands/meta/prompt.md rename to archived/v1.9.0/dot-opencode/commands/meta/prompt.md diff --git a/.opencode/commands/meta/skill.md b/archived/v1.9.0/dot-opencode/commands/meta/skill.md similarity index 100% rename from .opencode/commands/meta/skill.md rename to archived/v1.9.0/dot-opencode/commands/meta/skill.md diff --git a/.opencode/commands/onboard.md b/archived/v1.9.0/dot-opencode/commands/onboard.md similarity index 100% rename from .opencode/commands/onboard.md rename to archived/v1.9.0/dot-opencode/commands/onboard.md diff --git a/.opencode/commands/plan-execute.md b/archived/v1.9.0/dot-opencode/commands/plan-execute.md similarity index 100% rename from .opencode/commands/plan-execute.md rename to archived/v1.9.0/dot-opencode/commands/plan-execute.md diff --git a/.opencode/commands/pv-mesh.md b/archived/v1.9.0/dot-opencode/commands/pv-mesh.md similarity index 100% rename from .opencode/commands/pv-mesh.md rename to archived/v1.9.0/dot-opencode/commands/pv-mesh.md diff --git a/.opencode/commands/pv.md b/archived/v1.9.0/dot-opencode/commands/pv.md similarity index 100% rename from .opencode/commands/pv.md rename to archived/v1.9.0/dot-opencode/commands/pv.md diff --git a/.opencode/commands/question.md b/archived/v1.9.0/dot-opencode/commands/question.md similarity index 100% rename from .opencode/commands/question.md rename to archived/v1.9.0/dot-opencode/commands/question.md diff --git a/.opencode/commands/recall.md b/archived/v1.9.0/dot-opencode/commands/recall.md similarity index 100% rename from .opencode/commands/recall.md rename to archived/v1.9.0/dot-opencode/commands/recall.md diff --git a/.opencode/commands/research-swarm.md b/archived/v1.9.0/dot-opencode/commands/research-swarm.md similarity index 100% rename from .opencode/commands/research-swarm.md rename to archived/v1.9.0/dot-opencode/commands/research-swarm.md diff --git a/.opencode/commands/route.md b/archived/v1.9.0/dot-opencode/commands/route.md similarity index 100% rename from .opencode/commands/route.md rename to archived/v1.9.0/dot-opencode/commands/route.md diff --git a/.opencode/commands/squad/cron.md b/archived/v1.9.0/dot-opencode/commands/squad/cron.md similarity index 100% rename from .opencode/commands/squad/cron.md rename to archived/v1.9.0/dot-opencode/commands/squad/cron.md diff --git a/.opencode/commands/squad/init.md b/archived/v1.9.0/dot-opencode/commands/squad/init.md similarity index 100% rename from .opencode/commands/squad/init.md rename to archived/v1.9.0/dot-opencode/commands/squad/init.md diff --git a/.opencode/commands/squad/standup.md b/archived/v1.9.0/dot-opencode/commands/squad/standup.md similarity index 100% rename from .opencode/commands/squad/standup.md rename to archived/v1.9.0/dot-opencode/commands/squad/standup.md diff --git a/.opencode/commands/squad/status.md b/archived/v1.9.0/dot-opencode/commands/squad/status.md similarity index 100% rename from .opencode/commands/squad/status.md rename to archived/v1.9.0/dot-opencode/commands/squad/status.md diff --git a/.opencode/commands/squad/task.md b/archived/v1.9.0/dot-opencode/commands/squad/task.md similarity index 100% rename from .opencode/commands/squad/task.md rename to archived/v1.9.0/dot-opencode/commands/squad/task.md diff --git a/.opencode/commands/teleport-sync.md b/archived/v1.9.0/dot-opencode/commands/teleport-sync.md similarity index 100% rename from .opencode/commands/teleport-sync.md rename to archived/v1.9.0/dot-opencode/commands/teleport-sync.md diff --git a/.opencode/commands/todo-check.md b/archived/v1.9.0/dot-opencode/commands/todo-check.md similarity index 100% rename from .opencode/commands/todo-check.md rename to archived/v1.9.0/dot-opencode/commands/todo-check.md diff --git a/.opencode/commands/todo-new.md b/archived/v1.9.0/dot-opencode/commands/todo-new.md similarity index 100% rename from .opencode/commands/todo-new.md rename to archived/v1.9.0/dot-opencode/commands/todo-new.md diff --git a/.opencode/commands/tts.md b/archived/v1.9.0/dot-opencode/commands/tts.md similarity index 100% rename from .opencode/commands/tts.md rename to archived/v1.9.0/dot-opencode/commands/tts.md diff --git a/.opencode/plugin.json b/archived/v1.9.0/dot-opencode/plugin.json similarity index 100% rename from .opencode/plugin.json rename to archived/v1.9.0/dot-opencode/plugin.json diff --git a/.opencode/skills-registry.json b/archived/v1.9.0/dot-opencode/skills-registry.json similarity index 100% rename from .opencode/skills-registry.json rename to archived/v1.9.0/dot-opencode/skills-registry.json diff --git a/.opencode/skills/agentic-course/lessons/01-reality-check.md b/archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/01-reality-check.md similarity index 100% rename from .opencode/skills/agentic-course/lessons/01-reality-check.md rename to archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/01-reality-check.md diff --git a/.opencode/skills/agentic-course/lessons/02-mental-models.md b/archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/02-mental-models.md similarity index 100% rename from .opencode/skills/agentic-course/lessons/02-mental-models.md rename to archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/02-mental-models.md diff --git a/.opencode/skills/agentic-course/lessons/03-first-autonomous-task.md b/archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/03-first-autonomous-task.md similarity index 100% rename from .opencode/skills/agentic-course/lessons/03-first-autonomous-task.md rename to archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/03-first-autonomous-task.md diff --git a/.opencode/skills/agentic-course/lessons/04-craft-framework.md b/archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/04-craft-framework.md similarity index 100% rename from .opencode/skills/agentic-course/lessons/04-craft-framework.md rename to archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/04-craft-framework.md diff --git a/.opencode/skills/agentic-course/lessons/05-six-core-areas.md b/archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/05-six-core-areas.md similarity index 100% rename from .opencode/skills/agentic-course/lessons/05-six-core-areas.md rename to archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/05-six-core-areas.md diff --git a/.opencode/skills/agentic-course/lessons/06-three-tier-boundaries.md b/archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/06-three-tier-boundaries.md similarity index 100% rename from .opencode/skills/agentic-course/lessons/06-three-tier-boundaries.md rename to archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/06-three-tier-boundaries.md diff --git a/.opencode/skills/agentic-course/lessons/07-loop-fundamentals.md b/archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/07-loop-fundamentals.md similarity index 100% rename from .opencode/skills/agentic-course/lessons/07-loop-fundamentals.md rename to archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/07-loop-fundamentals.md diff --git a/.opencode/skills/agentic-course/lessons/08-circuit-breakers.md b/archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/08-circuit-breakers.md similarity index 100% rename from .opencode/skills/agentic-course/lessons/08-circuit-breakers.md rename to archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/08-circuit-breakers.md diff --git a/.opencode/skills/agentic-course/lessons/09-state-management.md b/archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/09-state-management.md similarity index 100% rename from .opencode/skills/agentic-course/lessons/09-state-management.md rename to archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/09-state-management.md diff --git a/.opencode/skills/agentic-course/lessons/10-multi-agent-orchestration.md b/archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/10-multi-agent-orchestration.md similarity index 100% rename from .opencode/skills/agentic-course/lessons/10-multi-agent-orchestration.md rename to archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/10-multi-agent-orchestration.md diff --git a/.opencode/skills/agentic-course/lessons/11-context-engineering.md b/archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/11-context-engineering.md similarity index 100% rename from .opencode/skills/agentic-course/lessons/11-context-engineering.md rename to archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/11-context-engineering.md diff --git a/.opencode/skills/agentic-course/lessons/12-compute-advantage.md b/archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/12-compute-advantage.md similarity index 100% rename from .opencode/skills/agentic-course/lessons/12-compute-advantage.md rename to archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/12-compute-advantage.md diff --git a/.opencode/skills/agentic-course/lessons/13-building-your-system.md b/archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/13-building-your-system.md similarity index 100% rename from .opencode/skills/agentic-course/lessons/13-building-your-system.md rename to archived/v1.9.0/dot-opencode/skills/agentic-course/lessons/13-building-your-system.md diff --git a/.opencode/skills/agentic-course/references/boundaries.md b/archived/v1.9.0/dot-opencode/skills/agentic-course/references/boundaries.md similarity index 100% rename from .opencode/skills/agentic-course/references/boundaries.md rename to archived/v1.9.0/dot-opencode/skills/agentic-course/references/boundaries.md diff --git a/.opencode/skills/agentic-course/references/craft.md b/archived/v1.9.0/dot-opencode/skills/agentic-course/references/craft.md similarity index 100% rename from .opencode/skills/agentic-course/references/craft.md rename to archived/v1.9.0/dot-opencode/skills/agentic-course/references/craft.md diff --git a/.opencode/skills/agentic-course/references/loops.md b/archived/v1.9.0/dot-opencode/skills/agentic-course/references/loops.md similarity index 100% rename from .opencode/skills/agentic-course/references/loops.md rename to archived/v1.9.0/dot-opencode/skills/agentic-course/references/loops.md diff --git a/.opencode/skills/agentic-course/skill.md b/archived/v1.9.0/dot-opencode/skills/agentic-course/skill.md similarity index 100% rename from .opencode/skills/agentic-course/skill.md rename to archived/v1.9.0/dot-opencode/skills/agentic-course/skill.md diff --git a/.opencode/skills/archived/latex-pdf-generator.md b/archived/v1.9.0/dot-opencode/skills/archived/latex-pdf-generator.md similarity index 100% rename from .opencode/skills/archived/latex-pdf-generator.md rename to archived/v1.9.0/dot-opencode/skills/archived/latex-pdf-generator.md diff --git a/.opencode/skills/browser-usage-prompt-guide/skill.md b/archived/v1.9.0/dot-opencode/skills/browser-usage-prompt-guide/skill.md similarity index 100% rename from .opencode/skills/browser-usage-prompt-guide/skill.md rename to archived/v1.9.0/dot-opencode/skills/browser-usage-prompt-guide/skill.md diff --git a/.opencode/skills/changelog-architect/skill.md b/archived/v1.9.0/dot-opencode/skills/changelog-architect/skill.md similarity index 100% rename from .opencode/skills/changelog-architect/skill.md rename to archived/v1.9.0/dot-opencode/skills/changelog-architect/skill.md diff --git a/.opencode/skills/compute-advantage/skill.md b/archived/v1.9.0/dot-opencode/skills/compute-advantage/skill.md similarity index 100% rename from .opencode/skills/compute-advantage/skill.md rename to archived/v1.9.0/dot-opencode/skills/compute-advantage/skill.md diff --git a/.opencode/skills/content-creation/skill.md b/archived/v1.9.0/dot-opencode/skills/content-creation/skill.md similarity index 100% rename from .opencode/skills/content-creation/skill.md rename to archived/v1.9.0/dot-opencode/skills/content-creation/skill.md diff --git a/.opencode/skills/cost-tracker/skill.md b/archived/v1.9.0/dot-opencode/skills/cost-tracker/skill.md similarity index 100% rename from .opencode/skills/cost-tracker/skill.md rename to archived/v1.9.0/dot-opencode/skills/cost-tracker/skill.md diff --git a/.opencode/skills/debugging/skill.md b/archived/v1.9.0/dot-opencode/skills/debugging/skill.md similarity index 100% rename from .opencode/skills/debugging/skill.md rename to archived/v1.9.0/dot-opencode/skills/debugging/skill.md diff --git a/.opencode/skills/deep-research/skill.md b/archived/v1.9.0/dot-opencode/skills/deep-research/skill.md similarity index 100% rename from .opencode/skills/deep-research/skill.md rename to archived/v1.9.0/dot-opencode/skills/deep-research/skill.md diff --git a/.opencode/skills/evaluator/skill.md b/archived/v1.9.0/dot-opencode/skills/evaluator/skill.md similarity index 100% rename from .opencode/skills/evaluator/skill.md rename to archived/v1.9.0/dot-opencode/skills/evaluator/skill.md diff --git a/.opencode/skills/knowledge-management/skill.md b/archived/v1.9.0/dot-opencode/skills/knowledge-management/skill.md similarity index 100% rename from .opencode/skills/knowledge-management/skill.md rename to archived/v1.9.0/dot-opencode/skills/knowledge-management/skill.md diff --git a/.opencode/skills/kpi/skill.md b/archived/v1.9.0/dot-opencode/skills/kpi/skill.md similarity index 100% rename from .opencode/skills/kpi/skill.md rename to archived/v1.9.0/dot-opencode/skills/kpi/skill.md diff --git a/.opencode/skills/memory-system/skill.md b/archived/v1.9.0/dot-opencode/skills/memory-system/skill.md similarity index 100% rename from .opencode/skills/memory-system/skill.md rename to archived/v1.9.0/dot-opencode/skills/memory-system/skill.md diff --git a/.opencode/skills/meta-skill/skill.md b/archived/v1.9.0/dot-opencode/skills/meta-skill/skill.md similarity index 100% rename from .opencode/skills/meta-skill/skill.md rename to archived/v1.9.0/dot-opencode/skills/meta-skill/skill.md diff --git a/.opencode/skills/newsletter-launch/skill.md b/archived/v1.9.0/dot-opencode/skills/newsletter-launch/skill.md similarity index 100% rename from .opencode/skills/newsletter-launch/skill.md rename to archived/v1.9.0/dot-opencode/skills/newsletter-launch/skill.md diff --git a/.opencode/skills/overseer/skill.md b/archived/v1.9.0/dot-opencode/skills/overseer/skill.md similarity index 100% rename from .opencode/skills/overseer/skill.md rename to archived/v1.9.0/dot-opencode/skills/overseer/skill.md diff --git a/.opencode/skills/parallel-verification/skill.md b/archived/v1.9.0/dot-opencode/skills/parallel-verification/skill.md similarity index 100% rename from .opencode/skills/parallel-verification/skill.md rename to archived/v1.9.0/dot-opencode/skills/parallel-verification/skill.md diff --git a/.opencode/skills/pattern-detector/skill.md b/archived/v1.9.0/dot-opencode/skills/pattern-detector/skill.md similarity index 100% rename from .opencode/skills/pattern-detector/skill.md rename to archived/v1.9.0/dot-opencode/skills/pattern-detector/skill.md diff --git a/.opencode/skills/plan-execute/skill.md b/archived/v1.9.0/dot-opencode/skills/plan-execute/skill.md similarity index 100% rename from .opencode/skills/plan-execute/skill.md rename to archived/v1.9.0/dot-opencode/skills/plan-execute/skill.md diff --git a/.opencode/skills/project-setup/skill.md b/archived/v1.9.0/dot-opencode/skills/project-setup/skill.md similarity index 100% rename from .opencode/skills/project-setup/skill.md rename to archived/v1.9.0/dot-opencode/skills/project-setup/skill.md diff --git a/.opencode/skills/prompt-engineering/improve.md b/archived/v1.9.0/dot-opencode/skills/prompt-engineering/improve.md similarity index 100% rename from .opencode/skills/prompt-engineering/improve.md rename to archived/v1.9.0/dot-opencode/skills/prompt-engineering/improve.md diff --git a/.opencode/skills/prompt-engineering/review.md b/archived/v1.9.0/dot-opencode/skills/prompt-engineering/review.md similarity index 100% rename from .opencode/skills/prompt-engineering/review.md rename to archived/v1.9.0/dot-opencode/skills/prompt-engineering/review.md diff --git a/.opencode/skills/prompt-engineering/skill.md b/archived/v1.9.0/dot-opencode/skills/prompt-engineering/skill.md similarity index 100% rename from .opencode/skills/prompt-engineering/skill.md rename to archived/v1.9.0/dot-opencode/skills/prompt-engineering/skill.md diff --git a/.opencode/skills/prompt-engineering/validate.md b/archived/v1.9.0/dot-opencode/skills/prompt-engineering/validate.md similarity index 100% rename from .opencode/skills/prompt-engineering/validate.md rename to archived/v1.9.0/dot-opencode/skills/prompt-engineering/validate.md diff --git a/.opencode/skills/react-best-practices/references/async-patterns.md b/archived/v1.9.0/dot-opencode/skills/react-best-practices/references/async-patterns.md similarity index 100% rename from .opencode/skills/react-best-practices/references/async-patterns.md rename to archived/v1.9.0/dot-opencode/skills/react-best-practices/references/async-patterns.md diff --git a/.opencode/skills/react-best-practices/references/bundle-patterns.md b/archived/v1.9.0/dot-opencode/skills/react-best-practices/references/bundle-patterns.md similarity index 100% rename from .opencode/skills/react-best-practices/references/bundle-patterns.md rename to archived/v1.9.0/dot-opencode/skills/react-best-practices/references/bundle-patterns.md diff --git a/.opencode/skills/react-best-practices/references/js-patterns.md b/archived/v1.9.0/dot-opencode/skills/react-best-practices/references/js-patterns.md similarity index 100% rename from .opencode/skills/react-best-practices/references/js-patterns.md rename to archived/v1.9.0/dot-opencode/skills/react-best-practices/references/js-patterns.md diff --git a/.opencode/skills/react-best-practices/references/rendering-patterns.md b/archived/v1.9.0/dot-opencode/skills/react-best-practices/references/rendering-patterns.md similarity index 100% rename from .opencode/skills/react-best-practices/references/rendering-patterns.md rename to archived/v1.9.0/dot-opencode/skills/react-best-practices/references/rendering-patterns.md diff --git a/.opencode/skills/react-best-practices/references/rerender-patterns.md b/archived/v1.9.0/dot-opencode/skills/react-best-practices/references/rerender-patterns.md similarity index 100% rename from .opencode/skills/react-best-practices/references/rerender-patterns.md rename to archived/v1.9.0/dot-opencode/skills/react-best-practices/references/rerender-patterns.md diff --git a/.opencode/skills/react-best-practices/references/server-patterns.md b/archived/v1.9.0/dot-opencode/skills/react-best-practices/references/server-patterns.md similarity index 100% rename from .opencode/skills/react-best-practices/references/server-patterns.md rename to archived/v1.9.0/dot-opencode/skills/react-best-practices/references/server-patterns.md diff --git a/.opencode/skills/react-best-practices/skill.md b/archived/v1.9.0/dot-opencode/skills/react-best-practices/skill.md similarity index 100% rename from .opencode/skills/react-best-practices/skill.md rename to archived/v1.9.0/dot-opencode/skills/react-best-practices/skill.md diff --git a/.opencode/skills/skill-builder/skill.md b/archived/v1.9.0/dot-opencode/skills/skill-builder/skill.md similarity index 100% rename from .opencode/skills/skill-builder/skill.md rename to archived/v1.9.0/dot-opencode/skills/skill-builder/skill.md diff --git a/.opencode/skills/slop-fix/skill.md b/archived/v1.9.0/dot-opencode/skills/slop-fix/skill.md similarity index 100% rename from .opencode/skills/slop-fix/skill.md rename to archived/v1.9.0/dot-opencode/skills/slop-fix/skill.md diff --git a/.opencode/skills/slop-scan/skill.md b/archived/v1.9.0/dot-opencode/skills/slop-scan/skill.md similarity index 100% rename from .opencode/skills/slop-scan/skill.md rename to archived/v1.9.0/dot-opencode/skills/slop-scan/skill.md diff --git a/.opencode/skills/squad/skill.md b/archived/v1.9.0/dot-opencode/skills/squad/skill.md similarity index 100% rename from .opencode/skills/squad/skill.md rename to archived/v1.9.0/dot-opencode/skills/squad/skill.md diff --git a/.opencode/skills/stop-slop/references/phrases.md b/archived/v1.9.0/dot-opencode/skills/stop-slop/references/phrases.md similarity index 100% rename from .opencode/skills/stop-slop/references/phrases.md rename to archived/v1.9.0/dot-opencode/skills/stop-slop/references/phrases.md diff --git a/.opencode/skills/stop-slop/references/structures.md b/archived/v1.9.0/dot-opencode/skills/stop-slop/references/structures.md similarity index 100% rename from .opencode/skills/stop-slop/references/structures.md rename to archived/v1.9.0/dot-opencode/skills/stop-slop/references/structures.md diff --git a/.opencode/skills/stop-slop/skill.md b/archived/v1.9.0/dot-opencode/skills/stop-slop/skill.md similarity index 100% rename from .opencode/skills/stop-slop/skill.md rename to archived/v1.9.0/dot-opencode/skills/stop-slop/skill.md diff --git a/.opencode/skills/tdd/skill.md b/archived/v1.9.0/dot-opencode/skills/tdd/skill.md similarity index 100% rename from .opencode/skills/tdd/skill.md rename to archived/v1.9.0/dot-opencode/skills/tdd/skill.md diff --git a/.opencode/skills/worktree-manager/skill.md b/archived/v1.9.0/dot-opencode/skills/worktree-manager/skill.md similarity index 100% rename from .opencode/skills/worktree-manager/skill.md rename to archived/v1.9.0/dot-opencode/skills/worktree-manager/skill.md diff --git a/.opencode/skills/youtube-learner/skill.md b/archived/v1.9.0/dot-opencode/skills/youtube-learner/skill.md similarity index 100% rename from .opencode/skills/youtube-learner/skill.md rename to archived/v1.9.0/dot-opencode/skills/youtube-learner/skill.md diff --git a/examples/fullstack-app-setup.md b/archived/v1.9.0/examples/fullstack-app-setup.md similarity index 100% rename from examples/fullstack-app-setup.md rename to archived/v1.9.0/examples/fullstack-app-setup.md diff --git a/hooks/hooks.json b/archived/v1.9.0/hooks/hooks.json similarity index 100% rename from hooks/hooks.json rename to archived/v1.9.0/hooks/hooks.json diff --git a/hooks/post-commit-improve.md b/archived/v1.9.0/hooks/post-commit-improve.md similarity index 100% rename from hooks/post-commit-improve.md rename to archived/v1.9.0/hooks/post-commit-improve.md diff --git a/archived/v1.9.0/index.html b/archived/v1.9.0/index.html new file mode 100644 index 0000000..ac1b434 --- /dev/null +++ b/archived/v1.9.0/index.html @@ -0,0 +1,1306 @@ + + + + + + Neural Open Code - AI That Learns & Evolves + + + + + + + + +
+ + + +
+
+ + OPEN_SOURCE // MIT_LICENSE +
+

OPEN SOURCE AI THAT
LEARNS & EVOLVES

+

+ > Transform Codex and Gemini into self-improving AI assistants that remember context, learn from every interaction, and evolve with your workflow_ +

+
+ + + + + VIEW_SOURCE + + QUICK_START +
+ +
+
+ + + + neural_open_code v1.5.0 — click to interact +
+
+
+ $ codex +
+
+ $ curl -fsSL https://raw.githubusercontent.com/brolag/neural-open-code/main/install.sh | bash +
+
+ [INIT] Neural Open Code v1.5.0 +
+
+ [OK] Installed: 10+ agents, 20+ skills +
+
+ [OK] Commands registered: 30+ slash commands +
+
+ [OK] Multi-AI ready: Codex + Gemini +
+
+ --- +
+
+ Run /onboard to start the guided tour_ +
+
+
+ > + +
+
+
+ +
+
+

FEATURES

+

> Superpowers for open source AI that learn and evolve with you_

+
+ +
+
+

SKILLS_MANAGER

+

Install, enable, disable, and update skills on demand. Interactive installer with categories and dependency resolution.

+
+ +
+

PERSISTENT_MEMORY

+

Facts, events, and session logs persist across conversations. Your AI remembers what matters to you.

+
+ +
+

CODE_QUALITY

+

Detect technical debt with /slop-scan, auto-fix safe issues with /slop-fix, and review PRs with /overseer.

+
+ +
+

MULTI_AI

+

Route tasks to Codex or Gemini based on strengths. Open source AI for every job.

+
+ +
+

NEURAL_LOOPS

+

Autonomous coding sessions with /loop command. AFK mode, plan-first loops, and typed workflows.

+
+ +
+

TTS_CONTROL

+

Voice and text summaries with granular control. Toggle audio, text, or both independently with /tts.

+
+
+
+ +
+
+

COMMANDS

+

> Essential slash commands for neural operations_

+
+ +
+
+ /onboard +

Interactive guided tour

+
+
+ /install-skills +

Add new skills

+
+
+ /manage-skills +

Enable/disable skills

+
+
+ /slop-scan +

Detect technical debt

+
+
+ /overseer +

Review PR quality

+
+
+ /loop "task" +

Autonomous coding loop

+
+
+ /remember +

Save to memory

+
+
+ /tts on|off +

Toggle voice/text

+
+
+
+ +
+
+

INSTALLATION

+

> Get started in 3 commands_

+
+ +
+

ONE_COMMAND_INSTALL

+ +
+
+ 1. Install everything + +
+ 
$ curl -fsSL https://raw.githubusercontent.com/brolag/neural-open-code/main/install.sh | bash
+
+ +
+
+ 2. Run the guided tour + +
+ 
> /onboard
+
+ +

The installer clones the repo, configures your shell, registers all commands, sets up hooks, and offers skill installation.

+
+
+ +
+

> READY TO EVOLVE?

+

Join developers building with AI that learns and improves over time.

+ + + + + CLONE_REPO + +
+ + + +
v1.5.0
+ + + + diff --git a/install.sh b/archived/v1.9.0/install.sh similarity index 100% rename from install.sh rename to archived/v1.9.0/install.sh diff --git a/output-styles/concise.md b/archived/v1.9.0/output-styles/concise.md similarity index 100% rename from output-styles/concise.md rename to archived/v1.9.0/output-styles/concise.md diff --git a/output-styles/default.md b/archived/v1.9.0/output-styles/default.md similarity index 100% rename from output-styles/default.md rename to archived/v1.9.0/output-styles/default.md diff --git a/output-styles/genui.md b/archived/v1.9.0/output-styles/genui.md similarity index 100% rename from output-styles/genui.md rename to archived/v1.9.0/output-styles/genui.md diff --git a/output-styles/html.md b/archived/v1.9.0/output-styles/html.md similarity index 100% rename from output-styles/html.md rename to archived/v1.9.0/output-styles/html.md diff --git a/output-styles/table.md b/archived/v1.9.0/output-styles/table.md similarity index 100% rename from output-styles/table.md rename to archived/v1.9.0/output-styles/table.md diff --git a/output-styles/tts.md b/archived/v1.9.0/output-styles/tts.md similarity index 100% rename from output-styles/tts.md rename to archived/v1.9.0/output-styles/tts.md diff --git a/output-styles/yaml.md b/archived/v1.9.0/output-styles/yaml.md similarity index 100% rename from output-styles/yaml.md rename to archived/v1.9.0/output-styles/yaml.md diff --git a/rules/prompt-quality.md b/archived/v1.9.0/rules/prompt-quality.md similarity index 100% rename from rules/prompt-quality.md rename to archived/v1.9.0/rules/prompt-quality.md diff --git a/schemas/expertise.schema.json b/archived/v1.9.0/schemas/expertise.schema.json similarity index 100% rename from schemas/expertise.schema.json rename to archived/v1.9.0/schemas/expertise.schema.json diff --git a/scripts/deep-research-hook.sh b/archived/v1.9.0/scripts/deep-research-hook.sh similarity index 100% rename from scripts/deep-research-hook.sh rename to archived/v1.9.0/scripts/deep-research-hook.sh diff --git a/scripts/event-indexer.js b/archived/v1.9.0/scripts/event-indexer.js similarity index 100% rename from scripts/event-indexer.js rename to archived/v1.9.0/scripts/event-indexer.js diff --git a/scripts/expertise-streamer.sh b/archived/v1.9.0/scripts/expertise-streamer.sh similarity index 100% rename from scripts/expertise-streamer.sh rename to archived/v1.9.0/scripts/expertise-streamer.sh diff --git a/scripts/expertise-watcher.sh b/archived/v1.9.0/scripts/expertise-watcher.sh similarity index 100% rename from scripts/expertise-watcher.sh rename to archived/v1.9.0/scripts/expertise-watcher.sh diff --git a/scripts/hooks/notify-telegram.sh b/archived/v1.9.0/scripts/hooks/notify-telegram.sh similarity index 100% rename from scripts/hooks/notify-telegram.sh rename to archived/v1.9.0/scripts/hooks/notify-telegram.sh diff --git a/scripts/hooks/post-task-learning.sh b/archived/v1.9.0/scripts/hooks/post-task-learning.sh similarity index 100% rename from scripts/hooks/post-task-learning.sh rename to archived/v1.9.0/scripts/hooks/post-task-learning.sh diff --git a/scripts/hooks/post-tool-use.sh b/archived/v1.9.0/scripts/hooks/post-tool-use.sh similarity index 100% rename from scripts/hooks/post-tool-use.sh rename to archived/v1.9.0/scripts/hooks/post-tool-use.sh diff --git a/scripts/hooks/session-start.sh b/archived/v1.9.0/scripts/hooks/session-start.sh similarity index 100% rename from scripts/hooks/session-start.sh rename to archived/v1.9.0/scripts/hooks/session-start.sh diff --git a/scripts/hooks/stop-tts.sh b/archived/v1.9.0/scripts/hooks/stop-tts.sh similarity index 100% rename from scripts/hooks/stop-tts.sh rename to archived/v1.9.0/scripts/hooks/stop-tts.sh diff --git a/scripts/hooks/user-prompt.sh b/archived/v1.9.0/scripts/hooks/user-prompt.sh similarity index 100% rename from scripts/hooks/user-prompt.sh rename to archived/v1.9.0/scripts/hooks/user-prompt.sh diff --git a/scripts/index-learnings.sh b/archived/v1.9.0/scripts/index-learnings.sh similarity index 100% rename from scripts/index-learnings.sh rename to archived/v1.9.0/scripts/index-learnings.sh diff --git a/scripts/install-skills.sh b/archived/v1.9.0/scripts/install-skills.sh similarity index 100% rename from scripts/install-skills.sh rename to archived/v1.9.0/scripts/install-skills.sh diff --git a/scripts/log-skill-execution.sh b/archived/v1.9.0/scripts/log-skill-execution.sh similarity index 100% rename from scripts/log-skill-execution.sh rename to archived/v1.9.0/scripts/log-skill-execution.sh diff --git a/scripts/loop-v3.sh b/archived/v1.9.0/scripts/loop-v3.sh similarity index 100% rename from scripts/loop-v3.sh rename to archived/v1.9.0/scripts/loop-v3.sh diff --git a/scripts/manage-skills.sh b/archived/v1.9.0/scripts/manage-skills.sh similarity index 100% rename from scripts/manage-skills.sh rename to archived/v1.9.0/scripts/manage-skills.sh diff --git a/scripts/neural-loop/README.md b/archived/v1.9.0/scripts/neural-loop/README.md similarity index 100% rename from scripts/neural-loop/README.md rename to archived/v1.9.0/scripts/neural-loop/README.md diff --git a/scripts/neural-loop/cancel.sh b/archived/v1.9.0/scripts/neural-loop/cancel.sh similarity index 100% rename from scripts/neural-loop/cancel.sh rename to archived/v1.9.0/scripts/neural-loop/cancel.sh diff --git a/scripts/neural-loop/neural-loop.sh b/archived/v1.9.0/scripts/neural-loop/neural-loop.sh similarity index 100% rename from scripts/neural-loop/neural-loop.sh rename to archived/v1.9.0/scripts/neural-loop/neural-loop.sh diff --git a/scripts/neural-loop/start.sh b/archived/v1.9.0/scripts/neural-loop/start.sh similarity index 100% rename from scripts/neural-loop/start.sh rename to archived/v1.9.0/scripts/neural-loop/start.sh diff --git a/scripts/neural-loop/test-on-stop.sh b/archived/v1.9.0/scripts/neural-loop/test-on-stop.sh similarity index 100% rename from scripts/neural-loop/test-on-stop.sh rename to archived/v1.9.0/scripts/neural-loop/test-on-stop.sh diff --git a/scripts/setup-hooks.sh b/archived/v1.9.0/scripts/setup-hooks.sh similarity index 100% rename from scripts/setup-hooks.sh rename to archived/v1.9.0/scripts/setup-hooks.sh diff --git a/scripts/squad/cron-setup.sh b/archived/v1.9.0/scripts/squad/cron-setup.sh similarity index 100% rename from scripts/squad/cron-setup.sh rename to archived/v1.9.0/scripts/squad/cron-setup.sh diff --git a/scripts/squad/heartbeat.sh b/archived/v1.9.0/scripts/squad/heartbeat.sh similarity index 100% rename from scripts/squad/heartbeat.sh rename to archived/v1.9.0/scripts/squad/heartbeat.sh diff --git a/scripts/squad/init.sh b/archived/v1.9.0/scripts/squad/init.sh similarity index 100% rename from scripts/squad/init.sh rename to archived/v1.9.0/scripts/squad/init.sh diff --git a/scripts/squad/msg.sh b/archived/v1.9.0/scripts/squad/msg.sh similarity index 100% rename from scripts/squad/msg.sh rename to archived/v1.9.0/scripts/squad/msg.sh diff --git a/scripts/squad/standup.sh b/archived/v1.9.0/scripts/squad/standup.sh similarity index 100% rename from scripts/squad/standup.sh rename to archived/v1.9.0/scripts/squad/standup.sh diff --git a/scripts/squad/status.sh b/archived/v1.9.0/scripts/squad/status.sh similarity index 100% rename from scripts/squad/status.sh rename to archived/v1.9.0/scripts/squad/status.sh diff --git a/scripts/squad/task.sh b/archived/v1.9.0/scripts/squad/task.sh similarity index 100% rename from scripts/squad/task.sh rename to archived/v1.9.0/scripts/squad/task.sh diff --git a/scripts/sync-plugin.sh b/archived/v1.9.0/scripts/sync-plugin.sh similarity index 100% rename from scripts/sync-plugin.sh rename to archived/v1.9.0/scripts/sync-plugin.sh diff --git a/scripts/tts-toggle.sh b/archived/v1.9.0/scripts/tts-toggle.sh similarity index 100% rename from scripts/tts-toggle.sh rename to archived/v1.9.0/scripts/tts-toggle.sh diff --git a/scripts/tts/elevenlabs.sh b/archived/v1.9.0/scripts/tts/elevenlabs.sh similarity index 100% rename from scripts/tts/elevenlabs.sh rename to archived/v1.9.0/scripts/tts/elevenlabs.sh diff --git a/scripts/utils/agent-name.sh b/archived/v1.9.0/scripts/utils/agent-name.sh similarity index 100% rename from scripts/utils/agent-name.sh rename to archived/v1.9.0/scripts/utils/agent-name.sh diff --git a/scripts/youtube-transcript.py b/archived/v1.9.0/scripts/youtube-transcript.py similarity index 100% rename from scripts/youtube-transcript.py rename to archived/v1.9.0/scripts/youtube-transcript.py diff --git a/status-lines/v1.sh b/archived/v1.9.0/status-lines/v1.sh similarity index 100% rename from status-lines/v1.sh rename to archived/v1.9.0/status-lines/v1.sh diff --git a/status-lines/v2.sh b/archived/v1.9.0/status-lines/v2.sh similarity index 100% rename from status-lines/v2.sh rename to archived/v1.9.0/status-lines/v2.sh diff --git a/status-lines/v3.sh b/archived/v1.9.0/status-lines/v3.sh similarity index 100% rename from status-lines/v3.sh rename to archived/v1.9.0/status-lines/v3.sh diff --git a/templates/craft.yaml b/archived/v1.9.0/templates/craft.yaml similarity index 100% rename from templates/craft.yaml rename to archived/v1.9.0/templates/craft.yaml diff --git a/templates/expertise.template.yaml b/archived/v1.9.0/templates/expertise.template.yaml similarity index 100% rename from templates/expertise.template.yaml rename to archived/v1.9.0/templates/expertise.template.yaml diff --git a/templates/expertise/manifest.yaml b/archived/v1.9.0/templates/expertise/manifest.yaml similarity index 100% rename from templates/expertise/manifest.yaml rename to archived/v1.9.0/templates/expertise/manifest.yaml diff --git a/templates/todo-workflow.md b/archived/v1.9.0/templates/todo-workflow.md similarity index 100% rename from templates/todo-workflow.md rename to archived/v1.9.0/templates/todo-workflow.md diff --git a/docs/.nojekyll b/docs/.nojekyll new file mode 100644 index 0000000..e69de29 diff --git a/docs/AGENT-HARNESS.md b/docs/AGENT-HARNESS.md new file mode 100644 index 0000000..d9c1c7d --- /dev/null +++ b/docs/AGENT-HARNESS.md @@ -0,0 +1,60 @@ +# Agent harness contract + +Neural OpenCode separates authoring from evaluation. The five skills form a +gated artifact flow rather than a collection of unrelated commands. + +```text +request + -> /discover -> unknowns-map.md + -> /spec -> plan.md + approval + -> /craft -> implementation + baseline/delta + -> /vet -> SHIP | HOLD + -> /exercise -> PASS | FAIL +``` + +## Authority by gate + +| Gate | May inspect | May write | Must not do | +|---|---|---|---| +| `/discover` | repository and relevant sources | `unknowns-map.md` | implement | +| `/spec` | map, repository, tests, docs | `plan.md` | implement | +| `/craft` | approved plan and implementation | code and evidence | self-approve or publish | +| `/vet` | neutral diff bundle and acceptance | review report | rewrite scope or excuse missing evidence | +| `/exercise` | runnable product and public docs | behavioral evidence | infer behavior from source alone | + +Small edits may enter later in the flow, but authority remains separated. A +builder cannot turn its own confidence into a `SHIP` verdict. + +## Why the harness is artifact-based + +The workflow treats code, plans, tests, and reports as an operational substrate: + +| Property | Neural OpenCode expression | +|---|---| +| Executable | Acceptance criteria name commands, tests, and observable outcomes. | +| Inspectable | Plans, diffs, baselines, review reports, and exercise evidence remain readable. | +| Stateful | The plan and its append-only amendments preserve progress across long tasks. | +| Governed | Approval, hook review, and ship boundaries are explicit state rather than prompt advice. | + +This is why a polished answer is not evidence by itself. The harness should be +able to observe what happened, verify it, preserve the result, and enforce the +authority boundary. + +## Durable context + +Artifacts live under `plans/-/`. They preserve decisions across +context compaction and allow a fresh reviewer to evaluate the change without +the author's narrative. Paths must remain inside the repository's `plans/` +boundary; the skills explicitly reject traversal and escaping symlinks. + +Load context selectively: repository rules and the active artifact first, then +only the implementation and references needed for the current gate. One focused +change per plan is easier to verify than several unrelated changes sharing a +context window. + +## Model use + +Newer models benefit from concise goals, explicit constraints, verifiable +outcomes, and permission boundaries. Neural OpenCode encodes those properties +in artifacts instead of relying on repeated prose. Model and permission +settings remain user configuration; see [CONFIGURATION.md](CONFIGURATION.md). diff --git a/docs/CONFIGURATION.md b/docs/CONFIGURATION.md new file mode 100644 index 0000000..73727d0 --- /dev/null +++ b/docs/CONFIGURATION.md @@ -0,0 +1,72 @@ +# Model and prompting guidance + +Neural OpenCode does not install or edit OpenCode configuration except for the +two project keys you add yourself (`plugin` and `skills.paths`). Review every +example against your own account, client version, permission, and cost policy. + +## Model availability comes first + +Do not copy a vendor model ID into `opencode.json` solely because a provider +guide discusses that model. Availability differs by product, account, and +client version. + +Prefer the OpenCode default or a model your client explicitly lists. Provider +access in one product does not imply OpenCode client access. + +## Balanced OpenCode policy + +This example intentionally leaves `model` unset and shows only the Neural +OpenCode install keys: + +```json +{ + "$schema": "https://opencode.ai/config.json", + "plugin": ["./plugins/neural-open-code"], + "skills": { + "paths": ["./plugins/neural-open-code/skills"] + } +} +``` + +Permission, sandbox, MCP, and agent fields stay under your control. The plugin +must not write them. + +To reverse installation, delete those two keys and restart OpenCode. + +## Optional compact rules + +OpenCode loads project `AGENTS.md` as always-on instructions. A short snippet +lives at `plugins/neural-open-code/rules/AGENTS.snippet.md`. Copy it only if +you want that overhead. The plugin does not inject rules into the system +prompt. + +## Task-based adjustments + +| Work | Notes | +|---|---| +| Mechanical, well-specified edit | Keep acceptance narrow and run tests. | +| Normal feature or refactor | Recommended general starting point. | +| Architecture, security, difficult debugging | Pair with explicit invariants and independent review. | + +Model strength is not permission. Approval and isolation boundaries should be +chosen independently of model capability. + +## Prompting principles + +Prefer: + +1. a concrete outcome and scope; +2. repository evidence and current constraints; +3. explicit authority and forbidden side effects; +4. executable acceptance criteria; +5. a clear stopping condition. + +The five Neural OpenCode skills encode this structure in durable artifacts. +Avoid duplicating the full plan in every message; point OpenCode at the +source-of-truth artifact and record material amendments there. + +Verify current behavior against the official +[OpenCode config](https://opencode.ai/docs/config), +[plugins](https://opencode.ai/docs/plugins), and +[skills](https://opencode.ai/docs/skills) docs before adopting a model ID in a +managed environment. diff --git a/docs/HOOKS.md b/docs/HOOKS.md new file mode 100644 index 0000000..f70fd79 --- /dev/null +++ b/docs/HOOKS.md @@ -0,0 +1,52 @@ +# Hooks + +Neural OpenCode packages lifecycle hooks in +`plugins/neural-open-code/index.js`. OpenCode 1.18.31 loads that module from +the project's `plugin` array and calls the returned `Hooks` object. + +## Included handlers + +| Handler | Event | Behavior | +|---|---|---| +| `dangerous-actions.js` | `tool.execute.before` | Blocks high-confidence destructive `bash` commands and protected-branch force-push patterns. | +| `sensitive-files.js` | `tool.execute.before` | Blocks `write` / `edit` / `apply_patch` changes to common secret-bearing files. | +| `prompt-injection.js` | `tool.execute.before` | Blocks obvious instruction-injection text in executable inputs while allowing documentation discussion. | +| `output-scanner.js` | `tool.execute.after` | Warns when tool output resembles credentials without repeating the detected value. | +| `pre-compact.js` | `experimental.session.compacting` | Writes `.opencode/compact-context.md` and adds a recovery pointer to compaction context. | + +Handlers use only the Node standard library. A thrown error from +`tool.execute.before` is the block signal. Non-blocking deletion warnings from +the Codex port have no first-class OpenCode hook channel, so they are omitted +rather than faked. + +## Trust + +Installing or enabling the plugin does not trust its hooks. OpenCode 1.18.31 +has no `/hooks` trust dialog. Read `plugins/neural-open-code/hooks/`, then keep +or remove the `plugin` entry in your project `opencode.json`. A changed hook +file should be reviewed again. + +## Boundaries + +Hooks reduce mistakes but do not replace: + +- OpenCode permission policy; +- filesystem and network isolation you configure yourself; +- repository branch protection; +- secret scanning in CI; +- human review for destructive or external side effects. + +The sensitive-file guard covers write/edit/apply_patch paths; it is not a +universal filesystem access control. The prompt-injection detector +intentionally targets obvious signals and cannot establish that arbitrary +external content is trustworthy. + +The plugin does not register a `config` hook and does not change model, +approval, MCP, or sandbox settings. + +## Validate + +```bash +node --test tests/hooks.test.js +python3 -m pytest -q tests/test_hooks.py +``` diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000..6abcd9f --- /dev/null +++ b/docs/README.md @@ -0,0 +1,16 @@ +# Neural OpenCode documentation + +Start with the [project README](../README.md), then use the narrow guide that +matches the task: + +- [Agent harness](AGENT-HARNESS.md): authority boundaries and artifact flow. +- [Workflow](WORKFLOW.md): `/discover`, `/spec`, `/craft`, `/vet`, and `/exercise`. +- [Hooks](HOOKS.md): installed handlers, limits, and trust review. +- [Configuration](CONFIGURATION.md): OpenCode model availability and safe policy examples. +- [Verification](VERIFICATION.md): automated, structural, review, and behavioral gates. +- [Architecture](../ARCHITECTURE.md): plugin package and config keys. + +The public overview is the [GitHub Page](index.html). Documentation should +describe only behavior present in `plugins/neural-open-code/`; unsupported +inventory must stay under `archived/v1.9.0/` rather than remaining as +aspirational documentation. diff --git a/docs/VERIFICATION.md b/docs/VERIFICATION.md new file mode 100644 index 0000000..2fac8f2 --- /dev/null +++ b/docs/VERIFICATION.md @@ -0,0 +1,50 @@ +# Verification + +Neural OpenCode uses four complementary evidence lanes. + +## 1. Structural validation + +The package manifest and skill layout must match OpenCode 1.18.31 conventions. + +```bash +python3 -m pytest -q tests/test_plugin_structure.py +``` + +This proves schema compatibility, not workflow correctness. + +## 2. Semantic tests + +```bash +python3 -m pytest -q +node --test tests/hooks.test.js +./scripts/doc-lint.sh +``` + +Tests assert the exact five-skill allowlist, plugin package shape, hook +behavior, trust documentation, path containment, stale-reference denial, and +GitHub Page links. + +## 3. Independent review + +`/vet` verifies the approved plan against a neutral change bundle. Every +required criterion must be `PASS`; missing required evidence prevents `SHIP`. + +## 4. Behavioral exercise + +`/exercise` follows the documented installation and workflow as a user, then +inspects the GitHub Page at desktop and mobile widths. Source inspection alone +cannot produce `PASS`. + +## Release gate + +A change is ready only when: + +- plugin structure and skill contracts pass; +- pytest, hook tests, and documentation lint pass; +- no unsupported inventory or stale claim remains; +- `/vet` returns `SHIP`; +- `/exercise` returns `PASS`; +- required pull-request checks are green. + +Publishing a GitHub release, npm package, or live Pages deploy is a separate +maintainer action and is not performed by this repository's default workflow. diff --git a/docs/WORKFLOW.md b/docs/WORKFLOW.md new file mode 100644 index 0000000..d2aea2e --- /dev/null +++ b/docs/WORKFLOW.md @@ -0,0 +1,88 @@ +# Workflow + +Neural OpenCode exposes exactly five skills: + +```text +/discover -> /spec -> approval -> /craft -> /vet + /exercise -> ship +``` + +## 1. Discover + +Use `/discover` when the request hides architectural choices, unfamiliar code, +security boundaries, or expensive assumptions. + +```text +/discover inspect this repository before we replace authentication +``` + +It writes `unknowns-map.md`, resolves architecture-changing questions, and +stops. Skip it for obvious low-risk work. + +## 2. Spec + +Use `/spec` to turn evidence into a build contract. + +```text +/spec plan the approved authentication migration +``` + +`plan.md` locks interfaces, CWE-tagged invariants, dependency-aware subtasks, +and executable acceptance. Its initial status is `draft`; implementation waits +for explicit approval. + +## 3. Craft + +Use `/craft` after reviewing and approving the plan. + +```text +/craft implement the plan we just approved +``` + +Craft captures a baseline, implements against locked signatures, verifies each +subtask, records deviations, and measures the final delta. It does not silently +commit, publish, deploy, or merge. + +## 4. Vet + +Use `/vet` as the independent pre-ship review. + +```text +/vet --spec plans/2026-07-12-example/plan.md --scope working-tree +``` + +The reviewer receives a neutral bundle, actively searches for counterexamples, +checks every required criterion, and returns exactly `SHIP` or `HOLD`. + +## 5. Exercise + +Use `/exercise` to verify the public workflow after automated checks. + +```text +/exercise --spec plans/2026-07-12-example/plan.md +``` + +Exercise drives the appropriate browser, desktop, CLI, installer, or docs +surface and captures direct evidence. It returns `PASS` or `FAIL`. + +## Artifact lifecycle + +```text +plans/-/ +├── unknowns-map.md # when discovery is needed +├── plan.md # source-of-truth contract +├── baseline.md # before metrics +├── delta.md # after metrics +├── vet-report.md # independent review +└── exercise-report.md +``` + +Artifacts are append-friendly and reviewable. Do not store credentials, +personal data, machine-specific caches, or unredacted sensitive output in them. + +## Choosing the smallest safe path + +- Obvious edit: implement and test directly. +- Clear non-trivial change: `/spec -> /craft -> /vet -> /exercise`. +- Ambiguous or high-cost change: start with `/discover`. + +The workflow adds gates based on uncertainty and consequence, not file count. diff --git a/docs/favicon.svg b/docs/favicon.svg new file mode 100644 index 0000000..2b82c75 --- /dev/null +++ b/docs/favicon.svg @@ -0,0 +1,4 @@ + + + + diff --git a/docs/index.html b/docs/index.html index 1892c33..55ac4ff 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1,344 +1,352 @@ - + - - - Neural OpenCode - Self-Improving AI Development System - - - - - + + + + Neural OpenCode — evidence-gated work + + + + + -
+ + + +
+ +
-
- -
+
+
+

OpenCode 1.18.31 plugin · five focused skills

+

Evidence before confidence.

+

Discover the unknowns. Lock the plan. Build against it. Review independently. Exercise what the user will actually touch.

+
+ Install Neural OpenCode + Read the workflow +
+
-
-
-
-
v1.5.0
-

Neural OpenCode Plugin

-

OpenCode that learns and improves from every interaction

-

- Every OpenCode session starts from zero. Neural OpenCode remembers. - It learns patterns, accumulates knowledge, and gets smarter over time. -

-
- Get Started - View on GitHub -
-
-
- 10+ - Agents -
-
- 20+ - Skills -
-
- 30+ - Commands -
-
- 3 - AI Models -
-
-
-
-
-
- - - - One Command Install -
- 
# Install Neural OpenCode
-curl -fsSL https://raw.githubusercontent.com/
-  brolag/neural-open-code/
-  main/install.sh | bash
+    

+      

+        

+          
One path. Five gates.

+          
Each skill has a distinct authority and stopping condition. Small work can enter later; material work keeps planning, building, review, and behavior separate.

+        

+        

+          
01 · map
/discover
Find architectural unknowns and produce an evidence-backed map.

+          
02 · contract
/spec
Lock signatures, invariants, dependencies, and executable acceptance.

+          
03 · build
/craft
Capture a baseline, implement the approved plan, and measure the delta.

+          
04 · challenge
/vet
Review in fresh context and return an evidence-backed SHIP or HOLD.

+          
05 · use
/exercise
Run tests, drive real behavior, and return PASS or FAIL.

+        

+      

+    

+
+    

+      

+        

+          
Guardrails with visible limits.

+          
Dependency-free Node hooks travel with the plugin. OpenCode does not trust them automatically: inspect plugins/neural-open-code/hooks/ first.

+        

+        

+          
tool.execute.before
Dangerous actions
Blocks high-confidence destructive shell commands and protected-branch force pushes.

+          
tool.execute.before
Sensitive files
Stops write, edit, and apply_patch changes to common credential files.

+          
tool.execute.after
Output scanning
Warns when tool output resembles secrets without echoing the detected value.

+          
session.compacting
Context recovery
Preserves a small project note so work can recover after compaction.

+        

+      

+    

+
+    

+      

+        

+          
Add two project keys. Nothing else.

+          
No copy script and no silent configuration mutation. Point OpenCode 1.18.31 at the plugin and skill path, restart, then review the hooks.

+        

+        

+          
+          
$ opencode --version
+# require 1.18.31 or later
 
-# Then run the guided tour
-/onboard
+# in your project's opencode.json
+{
+  "plugin": ["./plugins/neural-open-code"],
+  "skills": { "paths": ["./plugins/neural-open-code/skills"] }
+}

+        

+      

+    

 
-# Traditional vs Neural
-Traditional: Execute -> Forget -> Repeat
-Neural:      Execute -> Learn  -> Improve
-
-
-
+
+
+
+
Five skills. One plugin. No shadow inventory.
+

The 2.0 structure removes unsupported command bundles, courses, squads, loops, TTS, multi-AI mesh, and installers.

+
+
+ + 
opencode.example.json
+plugins/neural-open-code/
+├── package.json
+├── index.js
+├── skills/
+│   ├── discover/
+│   ├── spec/
+│   ├── craft/
+│   ├── vet/
+│   └── exercise/
+└── hooks/
+    └── *.js
+
+
+
-
-

Core Features

-
-
-
🎯
-

Skills Manager

-

Install, enable, disable, and update skills on demand. Interactive installer with categories and dependency resolution.

-
- /install-skills /manage-skills -
-
-
-
🧠
-

Persistent Memory

-

Facts, patterns, and learnings that survive restarts. Hot, warm, and cold memory tiers with global and project-level persistence.

-
- /remember /recall /forget -
-
-
-
🔍
-

Code Quality

-

Detect technical debt and auto-fix safe issues. Review PRs before merge with the overseer agent.

-
- /slop-scan /slop-fix /overseer -
-
-
-
🤖
-

Multi-AI Collaboration

-

Orchestrate Claude, Codex, and Gemini with intelligent routing based on task type and benchmarked strengths.

-
- /ai-collab /pv-mesh /plan-execute -
-
-
-
🔊
-

TTS Control

-

Voice and text summaries with granular control. Toggle audio, text summary, or both independently.

-
- /tts on /tts audio off /tts summary off -
-
-
-
🔄
-

Neural Loops

-

Autonomous coding sessions that iterate until done. AFK mode, plan-first loops, and typed workflows.

-
- /loop "Fix all tests" --max 10 -
-
-
-
+
+
+
+

Model choice stays with OpenCode and you.

+

Neural OpenCode never changes model, approvals, sandboxing, network access, MCP servers, or global configuration. Provider availability does not guarantee OpenCode availability.

+
+
+

Available model first

Use the OpenCode default or a model your client explicitly exposes. Apply structured prompting without hardcoding an unsupported ID.

+

Permission stays separate

A stronger model is not broader authority. Choose permission policy independently.

+
+
View configuration examplesReview the release gate
+
+
+
-
-

Specialized Agents

-

Each agent maintains expertise that evolves through usage

-
-
-
- 🏗️ -

meta-agent

-
-

Creates new agents dynamically based on patterns and requests

-
-
-
- 🧠 -

cognitive-amplifier

-
-

Enhanced thinking, bias detection, multi-perspective analysis

-
-
-
- 💡 -

insight-synthesizer

-
-

Cross-domain pattern discovery and breakthrough thinking

-
-
-
- 🔍 -

overseer

-
-

Review PRs and diffs for quality, security, and best practices

-
-
-
- 🤝 -

multi-ai

-
-

Orchestrates Claude, Codex, and Gemini for complex problems

-
- Claude 80.9% - Codex #1 - Gemini 1501 -
-
-
-
- 🚀 -

optimizer

-
-

Performance tuning and system optimization specialist

-
-
-
+
+
+ Neural OpenCode · OpenCode 1.18.31 plugin workflow + Docs · Source +
+
+ diff --git a/index.html b/index.html index ac1b434..803d717 100644 --- a/index.html +++ b/index.html @@ -1,1306 +1,352 @@ - + - - - Neural Open Code - AI That Learns & Evolves - - - - - + + + + Neural OpenCode — evidence-gated work + + + + + - -
- -