---
title: "OpenCode Workflow TL;DR - From One Giant Setup to Daily System"
description: "How one giant OpenCode setup note was split into a daily docs system covering provider setup, MCP, model choice, and fixes."
image: "https://8labs.id/opengraph.jpg"
date: "2026-03-16"
authors: "adekabang"
tags: ["docusaurus", "opencode", "workflow", "docs", "linux"]
---

> Documentation Index
> Fetch the complete documentation index at: https://8labs.id/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenCode Workflow TL;DR - From One Giant Setup to Daily System

I used to keep everything in one giant setup note, but in real life it was hard to use as a daily reference. Every time I needed one specific thing (provider setup, MCP, model choice, troubleshooting), I had to scroll through a giant wall of text.

So I turned it into a structured workflow map in the [OpenCode Overview](https://8labs.id/guides/opencode/overview): install, provider strategy, configuration, tools, operation mode, and troubleshooting.


## What Changed (TL;DR)

Instead of one massive guide, it is now split into practical pages:

- [Quick Start](https://8labs.id/guides/opencode/quick-start)
- [Installation](https://8labs.id/guides/opencode/installation)
- [Configuration](https://8labs.id/guides/opencode/configuration)
- [MCP Tools](https://8labs.id/guides/opencode/mcp-guide)
- [Project Rules](https://8labs.id/guides/opencode/project-rules)
- [Skills Integration](https://8labs.id/guides/opencode/skills-integration)
- [Planner Strategy](https://8labs.id/guides/opencode/planner-strategy)
- [Troubleshooting](https://8labs.id/guides/opencode/troubleshooting)

The main goal was simple: make this usable when actually working, not just "complete on paper."

## What's New (June 2026)

The guides section has been trimmed and expanded:

- **Narrative content** (provider strategy philosophy, agent personalities, tool philosophy) has been distilled — the guides now focus on concrete HOWTO steps
- **[ECC](https://8labs.id/guides/opencode/ecc)** — Everything Claude Code: 64 agents, 262 skills, 84 commands. Production-ready agent harness across Claude Code, OpenCode, Codex, and more
- **[Caveman](https://8labs.id/guides/opencode/caveman)** — Token compression that cuts ~75% output tokens with zero accuracy loss. One-line install, works across 30+ agents

## Workflow Mindset I'm Using Now

1. **Pick provider path first** (`opencode`, `opencode-go`, or `cliproxyapi`)
2. **Lock config once** (providers, models, variants, MCP)
3. **Operate with roles** (planner, worker, reviewer)
4. **Use focused references** for model decisions and troubleshooting

That alone reduced context switching a lot.

## Provider Strategy (Most Important Part)

One key clarification in the docs:

- `cliproxyapi` is not the only path.
- For this repo, `cliproxyapi` is mainly useful when I want multiple Codex-capable accounts behind one stable OpenAI-compatible endpoint, with retry/routing behavior centralized.

If I don't need account pooling/load balancing, direct provider paths stay simpler.

## Tooling That Actually Helped

Besides MCP tools and agent harnesses, two local CLI tools are worth installing:

```bash
brew install ripgrep ast-grep
```

- `rg` for fast text search
- `sg` for syntax-aware structural search

For advanced workflows, **ECC** adds 64 specialized subagents (planner, architect, tdd-guide, code-reviewer, security-reviewer) and **Caveman** cuts token costs by ~75% with a one-line install.

## Naming Reality Check

Another important thing I had to document clearly:

- Project branding now points to **oh-my-openagent**
- But many practical examples still use legacy names like `oh-my-opencode` in plugin/config keys

So the docs explain both without pretending one side doesn't exist.

## Final Take

This wasn't just a docs cleanup. It changed how I work with OpenCode day to day:

- faster onboarding
- clearer operational flow
- less re-reading giant setup notes
- better model/provider decisions during real tasks

If you're still running from one giant setup markdown, split it into workflow pages. It's one of those "small docs changes" that gives a big productivity return.

Source: https://8labs.id/blog/opencode-workflow-tldr/index.mdx
