@kitlangton/tailcode 0.1.1 → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kit Langton
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -41,6 +41,34 @@ opencode --version
 
 ## Run TailCode
 
+### Option 1: Binary Releases (Recommended)
+
+Download pre-built binaries from [GitHub Releases](https://github.com/kitlangton/tailcode/releases):
+
+```bash
+# macOS (Apple Silicon)
+curl -L -o tailcode https://github.com/kitlangton/tailcode/releases/latest/download/tailcode-darwin-arm64
+chmod +x tailcode
+./tailcode
+
+# macOS (Intel)
+curl -L -o tailcode https://github.com/kitlangton/tailcode/releases/latest/download/tailcode-darwin-x64
+chmod +x tailcode
+./tailcode
+
+# Linux (x64)
+curl -L -o tailcode https://github.com/kitlangton/tailcode/releases/latest/download/tailcode-linux-x64
+chmod +x tailcode
+./tailcode
+
+# Linux (ARM64)
+curl -L -o tailcode https://github.com/kitlangton/tailcode/releases/latest/download/tailcode-linux-arm64
+chmod +x tailcode
+./tailcode
+```
+
+### Option 2: Via Bun (requires Bun runtime)
+
 Requires Bun (the `tailcode` executable is a Bun CLI):
 
 ```bash
@@ -60,7 +88,7 @@ bun add -g @kitlangton/tailcode
 tailcode
 ```
 
-Run from source:
+### Option 3: Run from Source
 
 ```bash
 bun install
@@ -90,3 +118,48 @@ TAILCODE_PORT=4096 TAILCODE_PASSWORD=secret bun run start
 - OpenCode is bound to localhost to avoid exposing it on your LAN
 - Running `tailcode` again will auto-attach if OpenCode is already running locally
 - TailCode shows a local attach command after setup: `opencode attach http://127.0.0.1:4096`
+
+## Binary Releases
+
+We provide standalone binaries for:
+
+- **macOS**: `arm64` (Apple Silicon), `x64` (Intel)
+- **Linux**: `x64`, `arm64`
+- **Windows**: `x64` (coming soon)
+
+Binaries are compiled with Bun and include the Bun runtime. No separate Bun installation needed.
+
+### Verification
+
+All releases include SHA256 checksums in `SHA256SUMS`. Verify after download:
+
+```bash
+# macOS/Linux
+sha256sum -c SHA256SUMS
+```
+
+## Development
+
+### Building Locally
+
+```bash
+# Bundle for local testing
+bun run build:bundle
+
+# Compile for current platform
+bun run build:compile
+
+# Full release build (all platforms + checksums)
+bun run build:release
+```
+
+### Scripts
+
+- `bun run typecheck` - Type check with TypeScript
+- `bun run lint` - Lint with oxlint
+- `bun run fmt` - Format with oxfmt
+- `bun run check` - Run all checks (typecheck + lint + fmt)
+
+## License
+
+MIT

package/bin/tailcode.ts

@@ -6,7 +6,7 @@ const DEFAULT_PORT = 4096
 
 function printHelp() {
   process.stdout.write(
-    `tailcode\n\nUsage:\n  tailcode [--wizard] [--attach] [--help]\n\nOptions:\n  --wizard  Always open the TailCode setup wizard\n  --attach  Attach to an already-running local OpenCode server\n  --help    Show this help\n`,
+    `tailcode\n\nUsage:\n  tailcode [--attach] [--help]\n\nOptions:\n  --attach  Attach to an already-running local OpenCode server\n  --help    Show this help\n`,
   )
 }
 
@@ -35,8 +35,8 @@ async function isHealthy(port: number) {
 async function runAttach(port: number) {
   const bin = Bun.which("opencode")
   if (!bin) {
-    process.stderr.write("tailcode: 'opencode' is not installed (launching wizard instead)\n")
-    return false
+    process.stderr.write("tailcode: 'opencode' is not installed\n")
+    process.exit(1)
   }
 
   const target = `http://127.0.0.1:${port}`
@@ -52,7 +52,6 @@ async function runAttach(port: number) {
 }
 
 const args = process.argv.slice(2)
-const forceWizard = args.includes("--wizard")
 const forceAttach = args.includes("--attach")
 
 if (args.includes("--help") || args.includes("-h")) {
@@ -60,24 +59,17 @@ if (args.includes("--help") || args.includes("-h")) {
   process.exit(0)
 }
 
-if (forceWizard && forceAttach) {
-  process.stderr.write("tailcode: use either --wizard or --attach, not both\n")
-  process.exit(1)
-}
-
 const port = resolvePort()
 
-if (!forceWizard) {
+if (forceAttach) {
   const healthy = await isHealthy(port)
   if (healthy) {
     await runAttach(port)
-  }
-
-  if (forceAttach) {
+  } else {
     process.stderr.write(`tailcode: OpenCode is not running on http://127.0.0.1:${port}\n`)
-    process.stderr.write("tailcode: run without --attach to start the setup wizard\n")
     process.exit(1)
   }
 }
 
+// Default: always launch the wizard
 await import("../src/main.tsx")

package/bunfig.toml

@@ -0,0 +1 @@
+preload = ["@opentui/solid/preload"]

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@kitlangton/tailcode",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Terminal wizard for publishing OpenCode to your Tailscale tailnet",
-  "license": "UNLICENSED",
+  "license": "MIT",
   "type": "module",
   "repository": {
     "type": "git",
@@ -31,6 +31,8 @@
     "src/qr.ts",
     "src/state.ts",
     "src/services/*.ts",
+    "tsconfig.json",
+    "bunfig.toml",
     "README.md"
   ],
   "bin": {
@@ -49,8 +51,13 @@
     "fmt:check": "oxfmt --check src bin",
     "lint": "oxlint src bin",
     "check": "bun run typecheck && bun run lint && bun run fmt:check",
-    "publish:dry": "bun run check && bun publish --dry-run",
-    "publish:npm": "bun run check && bun publish"
+    "build": "bun run build.ts",
+    "build:bundle": "bun run build.ts bundle",
+    "build:compile": "bun run build.ts compile",
+    "build:release": "bun run build.ts release",
+    "smoke:bundle": "bun run ./dist/tailcode.js",
+    "publish:dry": "bun run check && bun run build && bun publish --dry-run",
+    "publish:npm": "bun run check && bun run build && bun publish"
   },
   "dependencies": {
     "@effect/atom-solid": "4.0.0-beta.11",

package/src/app.tsx

@@ -1,3 +1,5 @@
+/** @jsxImportSource @opentui/solid */
+
 import { useKeyboard, useTerminalDimensions } from "@opentui/solid"
 import { TextAttributes } from "@opentui/core"
 import { createMemo, createSignal, onCleanup, onMount, Show } from "solid-js"

package/src/main.tsx

@@ -1,3 +1,8 @@
+/** @jsxImportSource @opentui/solid */
+
+// Explicitly load the OpenTUI Solid preload (normally done via bunfig.toml in dev)
+import "@opentui/solid/preload"
+
 import { render } from "@opentui/solid"
 import { RegistryContext } from "@effect/atom-solid/RegistryContext"
 import { App } from "./app.js"

package/tsconfig.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "@tsconfig/bun/tsconfig.json",
+  "compilerOptions": {
+    "jsx": "preserve",
+    "jsxImportSource": "@opentui/solid",
+    "lib": ["ESNext", "DOM", "DOM.Iterable"],
+    "plugins": [{ "name": "@effect/language-service" }]
+  },
+  "include": ["src/**/*.ts", "src/**/*.tsx", "bin/**/*.ts"]
+}