A hands-on workshop introducing opencode, the open-source agentic coding CLI, and its free model offerings via opencode zen. Designed for developers who are comfortable with the terminal and git but new to agentic coding tools. By the end, you will have opencode installed, connected to a free model, and you will have completed three guided challenges.

• A terminal (a modern emulator such as WezTerm, Alacritty, Ghostty, or Kitty is recommended)
• git
• Node.js 20+ (only required if you install opencode via npm)
• An internet connection to download the installer and reach model providers

You will commit your challenge work into your own fork — not this upstream repo.

1. Open github.com/codebar/ai-workshop-opencode and click Fork (top right). Leave the defaults and confirm.
2. Copy the clone URL from your fork (green Code button), then clone it:

   git clone git@github.com:<your-username>/ai-workshop-opencode.git
   cd ai-workshop-opencode

   Prefer HTTPS? Use https://github.com/<your-username>/ai-workshop-opencode.git instead.
3. (Optional) Add the upstream so you can pull future updates from codebar:

   git remote add upstream https://github.com/codebar/ai-workshop-opencode.git

GitHub's full fork docs: https://docs.github.com/get-started/quickstart/fork-a-repo.

1. Fork and clone this repo (see above).
2. Pick your OS in docs/setup/ and follow the install guide.
3. Skim docs/setup/commands.md for the keybindings you will use during the session.
4. Open docs/slides/opencode_session_one.md and follow along with the workshop.

• macOS
• Windows
• Linux
• Commands reference — switch agents, switch models, manage sessions
• Models — free opencode zen models vs. GPT / Claude

• Session one — intro to opencode (Marp deck)
• How to preview slides

• Challenge one
• Challenge two
• Challenge three

See LICENSE.