Package Exports
- opencode-writer-swarm
- opencode-writer-swarm/dist/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (opencode-writer-swarm) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
OpenCode Writer Swarm
OpenCode-StoryForge
OpenCode-StoryForge is the editorial swarm plugin for OpenCode that orchestrates a curated team of AI agents to draft, research, revise, and polish multi-stage writing projects. Designed with GitHub and npm users in mind, it markets a catchy collaborative workflow, pro-level polishing crew, and clear configuration knobs while still linking down to the technical usage sections below.
Agents
- Editor-in-Chief: Orchestrator, direction setter.
- Writer: Draft creator.
- Researcher: Fact gatherer.
- Section Editor: Structure reviewer.
- Copy Editor: Language polisher and AI slop remover.
- Fact Checker: Verification expert.
- Reader Advocate: Audience representative.
Usage
Editor-in-Chief Role
OpenCode surfaces editor_in_chief as the primary role inside the UI, so you can pick it from the agent selector just like any other OpenCode plugin. When you kick off the Editor-in-Chief, StoryForge inherits whichever model you selected for that session (the same behavior as opencode-swarm), and you can still override the model via opencode-writer-swarm config if you need a different fallback.
- Add the plugin to your
opencode.json. - Configure models in
~/.config/opencode/opencode-writer-swarm.jsonor.opencode/opencode-writer-swarm.json. - Invoke
@editor_in_chiefwith a writing request.
Workflow
- Brief: Editor-in-Chief creates a brief.
- Research: Researcher gathers facts.
- Plan: Editor-in-Chief creates a content plan.
- Draft: Writer produces the first draft.
- Review: Section Editor, Copy Editor, Fact Checker, and Reader Advocate review the draft.
- Polish: Copy Editor does a final polish.
- Delivery: Final output saved to
.writer/final/.
Configuration
| Setting | Description |
|---|---|
config_validation_enabled (CONFIG_VALIDATION_ENABLED) |
Enables the prototype-pollution guard in deepMerge. Set to false to fall back to the previous behavior. |
FILE_VALIDATION_ENABLED |
Controls symlink/size/depth validation for .writer files. Disable to revert to the legacy permissive reader. |
FILE_RETRY_ENABLED / WRITER_MAX_RETRIES |
Toggles exponential backoff retries for writer file writes and limits the number of retries. |
LOG_REDACTION_ENABLED |
When true (default), startup logs redact keys ending in _KEY, _SECRET, or _TOKEN. Setting to false temporarily disables redaction for debugging. |
VERBOSE_INIT / LOG_LEVEL=debug |
Emit detailed initialization metadata (agent count, sanitized config keys) during plugin startup. |