aboutsummaryrefslogtreecommitdiffstats
path: root/.extras/docs/superpowers/specs/2026-03-31-opencode-bin-slackbuild-design.md
blob: e3120a57bbaf197dfa7e1ebb7c059f3a5660d3c0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
# opencode-bin SlackBuild — Design Spec

**Date:** 2026-03-31

---

## Overview

Package `opencode` (AI coding agent CLI) as `opencode-bin` by repackaging the
official pre-built binaries from GitHub releases. No compilation required —
the upstream Go binary is fully statically linked (`CGO_ENABLED=0`).

- **Upstream:** https://github.com/opencode-ai/opencode
- **Version at time of writing:** 0.0.55
- **License:** MIT

---

## Files

```
opencode-bin/
├── opencode-bin.SlackBuild
├── opencode-bin.info
├── README
└── slack-desc
```

Plus an entry in the repo-level `nvchecker.toml`.

---

## opencode-bin.SlackBuild

Follows the binary-repackaging pattern used by `kitty-bin` and `hugo` in this repo.

Key decisions:
- `PRGNAM=opencode-bin`; installed binary is named `opencode` (upstream command name)
- Supports `x86_64` (tarball: `opencode-linux-x86_64.tar.gz`) and `aarch64` (tarball: `opencode-linux-arm64.tar.gz`); all other arches exit with error
- Binary installed to `/usr/bin/opencode`
- Docs (`LICENSE`, `README.md`) installed to `/usr/doc/opencode-bin-$VERSION/`
- No `doinst.sh` — no system integration needed
- No stripping (pre-built binary; stripping a Go binary is harmless but unnecessary)

```bash
#!/bin/bash

# Slackware build script for opencode-bin

# Copyright 2026 danix <danix@danix.xyz>
# All rights reserved.
#
# Redistribution and use of this script, with or without modification, is
# permitted provided that the following conditions are met:
#
# 1. Redistributions of this script must retain the above copyright
#    notice, this list of conditions and the following disclaimer.
#
#  THIS SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS" AND ANY EXPRESS OR IMPLIED
#  WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
#  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO
#  EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
#  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
#  PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
#  OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
#  WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
#  OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
#  ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

cd $(dirname $0) ; CWD=$(pwd)

PRGNAM=opencode-bin
VERSION=${VERSION:-0.0.55}
BUILD=${BUILD:-1}
TAG=${TAG:-_SBo}
PKGTYPE=${PKGTYPE:-tgz}

if [ -z "$ARCH" ]; then
  case "$( uname -m )" in
    arm*) ARCH=arm ;;
       *) ARCH=$( uname -m ) ;;
  esac
fi

if [ ! -z "${PRINT_PACKAGE_NAME}" ]; then
  echo "$PRGNAM-$VERSION-$ARCH-$BUILD$TAG.$PKGTYPE"
  exit 0
fi

TMP=${TMP:-/tmp/SBo}
PKG=$TMP/package-$PRGNAM
OUTPUT=${OUTPUT:-/tmp}

if [ "$ARCH" = "x86_64" ]; then
  SRCARCH="x86_64"
elif [ "$ARCH" = "aarch64" ]; then
  SRCARCH="arm64"
else
  echo "$ARCH is not supported."
  exit 1
fi

set -e

rm -rf $PKG
mkdir -p $TMP $PKG $OUTPUT
cd $TMP
rm -rf $PRGNAM-$VERSION
mkdir -p $PRGNAM-$VERSION
tar xvf $CWD/opencode-linux-$SRCARCH.tar.gz -C $PRGNAM-$VERSION
cd $PRGNAM-$VERSION
chown -R root:root .
find -L . \
 \( -perm 777 -o -perm 775 -o -perm 750 -o -perm 711 -o -perm 555 \
  -o -perm 511 \) -exec chmod 755 {} \; -o \
 \( -perm 666 -o -perm 664 -o -perm 640 -o -perm 600 -o -perm 444 \
  -o -perm 440 -o -perm 400 \) -exec chmod 644 {} \;

mkdir -p $PKG/usr/bin
install -m 0755 opencode $PKG/usr/bin/opencode

mkdir -p $PKG/usr/doc/$PRGNAM-$VERSION
cp -a LICENSE README.md $PKG/usr/doc/$PRGNAM-$VERSION
cat $CWD/$PRGNAM.SlackBuild > $PKG/usr/doc/$PRGNAM-$VERSION/$PRGNAM.SlackBuild

mkdir -p $PKG/install
cat $CWD/slack-desc > $PKG/install/slack-desc

cd $PKG
/sbin/makepkg -l y -c n $OUTPUT/$PRGNAM-$VERSION-$ARCH-$BUILD$TAG.$PKGTYPE
```

---

## opencode-bin.info

```
PRGNAM="opencode-bin"
VERSION="0.0.55"
HOMEPAGE="https://github.com/opencode-ai/opencode"
DOWNLOAD="UNSUPPORTED"
MD5SUM=""
DOWNLOAD_x86_64="https://github.com/opencode-ai/opencode/releases/download/v0.0.55/opencode-linux-x86_64.tar.gz"
MD5SUM_x86_64=""
REQUIRES=""
MAINTAINER="danix"
EMAIL="danix@danix.xyz"
```

Note: `MD5SUM_x86_64` will be filled by running `sbofixinfo opencode-bin/` after downloading
the source with `sbodl`.

---

## README

```
opencode-bin is a pre-built binary repackage of opencode, a powerful AI
coding agent built for the terminal. It supports multiple LLM providers
including OpenAI, Anthropic, Google Gemini, and others.

No compilation is required; the official upstream binary is statically
linked and has no runtime library dependencies.

To use opencode, you need an API key for at least one supported LLM
provider. Set the appropriate environment variable (e.g. OPENAI_API_KEY,
ANTHROPIC_API_KEY) or configure it via opencode's interactive setup.

Homepage: https://github.com/opencode-ai/opencode

NOTE FOR aarch64 USERS: The aarch64 tarball is not listed in the .info
file (not a standard SBo field). Download it manually before building:
  wget https://github.com/opencode-ai/opencode/releases/download/v0.0.55/opencode-linux-arm64.tar.gz
```

---

## slack-desc

```
# HOW TO EDIT THIS FILE:
# The "handy ruler" below makes it easier to edit a package description.
# Line up the first '|' above the ':' following the base package name, and
# the '|' on the right side marks the last column you can put a character in.
# You must make exactly 11 lines for the formatting to be correct.  It's also
# customary to leave one blank line after the name.

        |-----handy-ruler------------------------------------------------------|
opencode-bin: opencode-bin (AI coding agent for the terminal)
opencode-bin:
opencode-bin: opencode is a powerful AI coding agent built for the terminal.
opencode-bin: It supports multiple LLM providers including OpenAI, Anthropic,
opencode-bin: Google Gemini, and others via simple configuration.
opencode-bin:
opencode-bin: This package ships the official pre-built binary. No compilation
opencode-bin: is required. API keys for a supported LLM provider are needed
opencode-bin: at runtime.
opencode-bin:
opencode-bin: Homepage: https://github.com/opencode-ai/opencode
```

---

## nvchecker.toml entry

```toml
[opencode-bin]
source = "github"
github = "opencode-ai/opencode"
use_latest_release = true
```

---

## Maintenance

When a new version is released:
1. Update `VERSION` in `.SlackBuild` and `.info`
2. Run `sbofixinfo opencode-bin/` to refresh checksums
3. Run `sbodl opencode-bin/` to verify the download
4. Run `sbolint opencode-bin/` to check for issues
5. Update `README` if the aarch64 download URL version number changed