KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #ai-agent #claude-code #mcp #typescript #codex #cli #rust #deepseek-harness

cocoplus

★ 718 Open GitHub ↗

CocoPlus is an Agentic Operating System for Snowflake Coco. It brings structured, multi-agent workflows to data engineering projects — covering everything from project initialization through spec, plan, build, test, review, and ship phases.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# CocoPlus

**CocoPlus** is an Agentic Operating System for Snowflake Coco. It brings structured, multi-agent workflows to data engineering projects — covering everything from project initialization through spec, plan, build, test, review, ship phases, browser observability, autonomous orchestration, and governance-aware execution.

Built using only Coco-native constructs: Skills, Agents, Hooks, and AGENTS.md.

## What It Does

CocoPlus wraps a structured development lifecycle around every project — from requirements capture through production ship — enforcing phase gates, parallel specialist execution, and checkpoint-validated delivery at each step. It decomposes work across fixed and dynamic specialist personas, runs coordinated workstreams, and tracks decisions, tokens, quality findings, contracts, memory, and governance signals across sessions.

The current operating layer includes:

- **CocoConsole**: a local, read-only browser control plane launched with `$cocoplus console`, including Flow, Cost, Sessions, Forge intent translation, and Fleet Comms visibility.
- **CocoPilot**: opt-in natural-language orchestration with `$pilot on` / `$pilot off`.
- **CocoForge**: goal-driven expert-team meta-loop with `$forge`.
- **Leviathan Mode + Ronin**: explicit-activation autonomous coordination with a personal assistant return briefing.
- **Dynamic Personas**: evidence-gated emergent specialists with retained history.
- **Governance hooks**: ReviewerLockout and PII governance with observe/enforce rollout.
- **Feature-owned runtime**: hooks enqueue deterministic work through idempotent, feature-owned skill contracts; CocoConsole is the only registered local runtime script.
- **CocoFlow orchestration**: tiered planning, pre-dispatch complexity scoring, committed run-policy snapshots, stage model floors, explicit human gates, inbox-first stage transitions, dependency-group dispatch, dotted branch topology, named artifacts, thinking-effort tuning, divergence at branch points, synthesis passes, and `$flow template` reuse.
- **CocoSession continuity**: PROGRESS handoff, predicate context, iteration and cost budgets with reserve landing, operator kill-switch, canonical terminal statuses, and one-shot steering for long-running work.
- **Evidence and proposal gates**: opt-in stage evidence checks and retained Snowflake-write proposals settled with `$flow settle`.
- **CocoWisdom distillation and negative memory**: terminal sessions can queue schema-declared wisdom distillation, contradiction review, progressive `$wisdom get <topic>` loading, `$wisdom reject` do-not-use records, and `$wisdom index` / `$wisdom recall` session-log search.
- **CocoStyle and CocoLex**: `$style init`, `$style refresh`, `$style show`, `$style mode`, `$style diff`, and `$style status` keep project conventions evidence-backed; `$lex define`, `$lex list`, `$lex show`, `$lex extract`, and `$lex validate` keep shared terminology explicit.
- **Operational awareness commands**: `$stall status`, `$stall thresholds`, `$stall reset`, `$pulse on`, `$pulse off`, `$pulse status`, `$pulse configure`, `$adversary run`, `$adversary audit`, `$adversary gap`, `$diary view`, `$diary list`, and `$diary search` expose no-progress detection, ambient observation, challenge review, and work journals.
- **CocoRoutine**: opt-in Snowflake TASK scheduling for completed self-contained flows with `$routine`.
- **Research, retrospective, hygiene, and correctness loops**: `$flow research`, `$retrospective run`, `$hygiene --model-upgrade`, `$meter benchmark`, `$meter compare`, `$meter verify`, `$meter waste`, and `$audit verify` make quality, coordination cost, adapter-backed transcript reconciliation, model drift, ACRR calibration, context waste, and audit integrity measurable.
- **CocoFleet goal mode**: `$fleet run`, `$fleet status`, and `$fleet comms` support planner/producer/read-only-critic orchestration with disjoint file scopes and signoff-driven completion.
- **Console-aware visual commands**: `$flow view` and `$meter view` redirect into CocoConsole when it is running.

The root plugin implements the current runtime and documentation surface while preserving older project state through explicit migration skills.

Older CocoPods migrate forward with `$migrate v2 --dry-run` and `$migrate v2`; new work should use the feature-owned skills directly. In V2.0.1, queued hook follow-up work uses durable request envelopes, stable idempotency keys, and skill-owned settlements so replayed queues do not duplicate meter, trace, or flow artifacts.

## Specialist Personas

`$de` Data Engineer · `$ae` Analytics Engineer · `$ds` Data Scientist · `$da` Data Analyst  
`$bi` BI Analyst · `$dpm` Data Product Manager · `$dst` Data Steward · `$cdo` Chief Data Officer

---

## Installation

Install directly from the GitHub repository with Coco's managed plugin installer:

```text
cortex plugin install Snowflake-Labs/cocoplus
cortex plugin enable cocoplus
```

You can also use the full repository URL:

```text
cortex plugin install https://github.com/Snowflake-Labs/cocoplus
```

For local development from a checkout, run this from the repository root:

```text
cortex plugin install . --force
cortex plugin enable cocoplus
```

### Upgrading an Existing CocoPlus Project

After installing the current plugin, open each existing CocoPlus project and run:

```text
$migrate v2 --dry-run
$migrate v2
```

Use the dry run first. It reports the exact project-state changes, tests, validation checks, and cleanup actions before anything is written.

For manual installation details, see [INSTALLATION.md](INSTALLATION.md).

## Getting Started

```
$pod init       — initialize CocoPlus in your project
$cocoplus on    — activate all features
$cocoplus console — open the read-only dashboard
$pilot on       — activate CocoPilot for the current session
$session status — inspect multi-session handoff and operator controls
$spec           — start the requirements phase
```

See [cocoplus.dev](https://cocoplus.dev) for the full documentation site.

---

## Requirements

- Snowflake Coco CLI (`cortex`) with plugin support
- Node.js (for hooks — Windows/Mac/Linux compatible)
- Git

## License

MIT — see [LICENSE](LICENSE)

## Warranty

The Software is provided as Open Source. This software is provided “as is” and any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall the owner or contributors be liable for any direct, indirect, incidental, special, exemplary, or consequential damages (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software, even if advised of the possibility of such damage.

## Legal

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

This is an Open Source repository and not an official Snowflake offering. This tool is not endorsed by Snowflake or any of the previous or current employers of the developers.

## Trademarks

This project may contain trademarks or logos for projects, products, or services. SNOWFLAKE is a trademark of Snowflake Computing, Inc in the United States and/or other countries. Any use of third-party trademarks or logos are subject to those third-party's policies.

cocoplus

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README