Rafael Fernandez

A practical guide to connect OpenCode with the remote GitHub MCP Server using a PAT, disable automatic OAuth, and avoid the most common auth errors.

We close the series with a practical evolution path: reuse the current domain and use cases to build a ratatui-powered TUI, keeping architecture intact while improving day-to-day interaction.

We close the implementation loop with persistence and testing: JSON-backed repository behavior, error strategy, repository contracts, and test coverage that protects refactoring.

We design the CLI adapter as if real people will use it daily: strict subcommands, safe enums, typed UUID input, and dual table/json output for both humans and scripts.

In this chapter we model the core of the project: the Task entity, immutable state transitions, and a layer-specific error taxonomy. Less magic, more explicit rules, fewer surprise bugs.