# OpenCode Starter Pack ReadMe - v1.2 - 2026-05-04

## 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. Run install.sh

```
install.sh
```

This will configure AGENTS.md.

4. Start opencode from the QuickStart project directory

```
cd QuickStartProject
opencode
```

5. Type in the prompt "Implement application described in prompt.txt"

6. Press enter and observe how agent is executing the instructions.

If your model is smart enough, you should end up with a working number guessing game in MUI.
(NOTE: DeepSeek V4 Flash model was tested to correctly implement the game)
(NOTE: you need to use the Build not Plan agent)

## 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 and their providers

Very Good
- MiMo V2.5 (OpenCode Go) (non-free)
- Kimi K2.6 (OpenCode Go) (non-free)
- DeepSeek V4 Pro (OpenCode Go) (non-free)
- DeepSeek V4 Flash (OpenCode Go) (non-free, fast) (dirt cheap)

Good
- DeepSeek V3.2 (Ollama Cloud) (free)
- Qwen 3.5 Plus (OpenCode Zen) (non-free) (cheap)

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

Acceptable, but requires a lot of hand holding
- MiniMax M2.5 (OpenCode Zen) (free)
- GLM 4.5 Air (OpenRouter) (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 located in the PlanExample subdirectory. 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 example plan (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 examples for Intuition, DOS, Graphics

### Legal

- SDK/Autodocs/#?.rst contains AROS autodocs, distributed under AROS Public License
- SDK/Autodocs/MUI/#?.md contains MUI autodocs, distributed with permission from Jens Maus and Thore Böckelmann
- SDK/Development contains AROS headers and libraries, distribute under AROS Public License or other licenses, check each file for license
- SDL/Examples contains source codes extracted from AROS repository, check each file for license

