Flux for OpenCode

[█████░░░░░░] ~45% feature parity with upstream

Native port of Flux for OpenCode.

---

Note: This port is based on Flux v1.9.x. The upstream Claude Code version is at v2.3.1 with significant new features not yet ported. See the parity table below.

---

Feature Parity with Upstream (Claude Code v2.3.1)

Core Workflow — Ported

Feature	Status	Notes
/flux:plan	✅	Core workflow
/flux:work	✅	Core workflow (sequential task execution)
/flux:scope	✅	Double Diamond scoping
/flux:sync	✅	State sync
/flux:impl-review	✅	Single-model per-task review
/flux:plan-review	✅	Plan review
/flux:epic-review	✅	Epic review (basic — see below for missing phases)
/flux:prime	✅	Codebase analysis (8 pillars)
/flux:setup	✅	Project initialization
/flux:contribute	✅	Bug fix PRs
/flux:desloppify	✅	Code quality scanning
/flux:ralph-init	✅	Autonomous overnight mode
/flux:worktree-kit	✅	Git worktree management
/flux:export-context	✅	RepoPrompt context export
fluxctl CLI	✅	All commands passing

v2.0+ Features — Not Yet Ported

Feature	Upstream Version	What it does
Brain Vault	v2.0.0	Single knowledge store replacing .flux/memory/. Area-organized pitfalls, principles, conventions. Wired into scope, work, and review.
Adversarial Dual-Model Review	v2.0.0	Two reviewer models (Anthropic + OpenAI) form independent verdicts with consensus merge.
BYORB (Bring Your Own Review Bot)	v2.0.0	Greptile and CodeRabbit integration with self-heal loop until confidence 5/5.
Browser QA in Review	v2.0.0	Agent-browser testing during epic review with checklist from scoping.
Security Scan in Review	v2.0.0	Auto-triggered STRIDE analysis on security-sensitive changes during epic review.
Self-Improving Harness	v2.0.0	Recommendation pulse at session start, two-layer frustration detection, meditate auto-nudge.
Review Severity Threshold	v2.0.0	Configurable which severities to auto-fix (critical, major, minor, style).
/flux:release	v2.0.0	Version-safe releases with manifest sync and CHANGELOG update.
/flux:propose	v2.1.0	Stakeholder feature proposals with implicit detection and engineering pushback.
/flux:rca	v2.2.0	Root cause analysis for bugs (Reproduce → Investigate → Root Cause → Verify → Fix → Learn).
Anti-Sycophancy Hardening	v2.2.1	Brain vault loaded into review prompts, independent adversarial verdicts enforced.
Human Review (Critique TUI)	v2.3.0	Opt-in terminal diff review after AI reviews finish.
/flux:reflect	v2.0.0	Post-session learning capture + skill extraction to brain vault.
/flux:ruminate	v2.0.0	Mine past conversations for uncaptured patterns.
/flux:meditate	v2.0.0	Audit and evolve brain vault — prune stale notes, promote pitfalls to principles.
Linear Integration	v1.9.9	Epic/task sync to Linear (projects, issues, status changes).
Project-Local Installs	v1.9.7	All MCPs, skills, config are project-scoped.

Partially Ported

Feature	Status	What's missing
/flux:improve	⚠️	Needs SQLite session adapter for OpenCode's session format
/flux:score	⚠️	Needs SQLite session adapter
/flux:profile	⚠️	Needs config adapter for OpenCode's config format
/flux:interview	⚠️	Removed from upstream — functionality merged into /flux:scope

Deprecated in This Port

Feature	Notes
memory-scout agent	Deprecated upstream — replaced by brain vault
fluxctl memory commands	Deprecated upstream — replaced by brain vault

---

Install

git clone https://github.com/Nairon-AI/flux-opencode.git
cd flux-opencode
./install.sh --project /path/to/your/project

Then in your project:

/flux:setup

---

Requirements

• OpenCode
• Python 3.9+
• jq

---

License

MIT

---

Discord · Upstream (Claude Code)