# OpenCode Starter Pack ReadMe - v1.0 - 2026-04-28

## Quick Start

1. Make sure you have AROS cross-compiler working and available on the path.

```
x86_64-aros-gcc test.c -o test
```

needs to work.

If you don't have a working cross-compiler, follow this guide (Windows/Linux)

https://arosnews.github.io/how-to-cross-compile-aros-hosted-wsl/

2. Install OpenCode

https://opencode.ai/download

```
curl -fsSL https://opencode.ai/install | bash
```

3. Edit QuickStartProject/AGENTS.md

In 'Environment Information' section update the paths to match setup on your system.

NOTE: All the directories mentioned there are present in AROS-SDK subdirectory of this pack.

4. Start opencode from the QuickStart project directory

```
cd QuickStartProject
opencode
```

5. Type in the prompt "Use PLAN.md. Use STEPS.md. Implement Step 1 from STEPS.md"

6. Press enter and observe how agent is working on preparing skeleton of example project.

If your model is smart enough, you should end up with a working Calculator binary that just opens a window.

## Detailed Information

### Models and Providers

OpenCode itself is relatively simple tool. The real brain behing OpenCode is the Model. Using different models will yield you different results.

OpenCode by default will use a free model from OpenCode Zen provider. You can use different models (/models command) and connect to different providers (/connect command). Below is a list of suggested models

Good
- DeepSeek V3.2 (Ollama Cloud) (free)

Good enough
- BigPicle (OpenCode Zen) (free)
- Hy3 (OpenCode Zen) (free)

Acceptable, but requires a lot of hand holding
- MiniMax M2.5 (OpenCode Zen) (free)

### AGENTS.md

This file contains high level instructions for the coding agent. It should be present in a project directory. It does not describe the project itself, but describes in general how to develop software specifically for AROS. It tells agent how to write code (code style), how to compile it, how to debug it. You can extend and modify this file to suite your needs.

### Plan vs Build

You can control how agents behave and what they do by planning work for them. This is useful for weaker models (most of free models), which will get confused with a long complicated task.

Check PLAN.md and STEPS.md included in the QuickStartProject. PLAN.md is high-level plan while STEPS.md list incremental steps that are used to build the application. Both of those documents were generated by a Model based on a prompt. It is often the case that a more powerfull (and expensive) model
is used to generate plan and then a weaker model is used to implement it.

Here are prompts used to generate the plan for QuickStartProject (using Kimi K2.5 model)

PLAN.md -> Create a plan for implementing Calculator application for AROS. Application should use intuition and gadtools and should not use MUI/Zune. Document overal design, high level implementation steps, required Libraries & APIs, build system etc.

STEPS.md -> Use PLAN.md. Divide work in plan into smaller steps. Each step should provide one working functionality implemented in both UI and logic.

Plan is useful when a longer development is expected. Alternatively you can guide the agent with step by step prompts.

### Examples

Many models will not know how to develop for AROS, but they can learn when they are given examples. If you notice that agent keeps on generaing wrong code, provide it with an example by coping it into Examples directory and point the agent to use it with a prompt.

### TODO

- add more examples for MUI
- add examples for Intuition, DOS, Graphics





