@kitlangton/tailcode 0.1.0 → 0.2.0

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
@@ -88,4 +116,50 @@ TAILCODE_PORT=4096 TAILCODE_PASSWORD=secret bun run start
 
 - The published URL is only reachable from devices on your Tailscale tailnet
 - 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

@@ -1,3 +1,83 @@
 #!/usr/bin/env bun
 
-import "../src/main.tsx"
+export {}
+
+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`,
+  )
+}
+
+function resolvePort() {
+  const raw = process.env.TAILCODE_PORT
+  if (!raw) return DEFAULT_PORT
+  const parsed = Number.parseInt(raw, 10)
+  return Number.isInteger(parsed) && parsed > 0 && parsed <= 65535 ? parsed : DEFAULT_PORT
+}
+
+async function isHealthy(port: number) {
+  const controller = new AbortController()
+  const timer = setTimeout(() => controller.abort(), 600)
+  try {
+    const response = await fetch(`http://127.0.0.1:${port}/global/health`, {
+      signal: controller.signal,
+    })
+    return response.ok
+  } catch {
+    return false
+  } finally {
+    clearTimeout(timer)
+  }
+}
+
+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
+  }
+
+  const target = `http://127.0.0.1:${port}`
+  process.stdout.write(`tailcode: attaching to ${target}\n`)
+
+  const child = Bun.spawn([bin, "attach", target], {
+    stdin: "inherit",
+    stdout: "inherit",
+    stderr: "inherit",
+  })
+
+  process.exit(await child.exited)
+}
+
+const args = process.argv.slice(2)
+const forceWizard = args.includes("--wizard")
+const forceAttach = args.includes("--attach")
+
+if (args.includes("--help") || args.includes("-h")) {
+  printHelp()
+  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) {
+  const healthy = await isHealthy(port)
+  if (healthy) {
+    await runAttach(port)
+  }
+
+  if (forceAttach) {
+    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)
+  }
+}
+
+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.0",
+  "version": "0.2.0",
   "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": {
@@ -45,10 +47,17 @@
     "showcase": "bun run --conditions=browser --preserve-symlinks src/showcase.tsx",
     "showcase:dev": "bun run --conditions=browser --preserve-symlinks --hot src/showcase.tsx",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "fmt": "oxfmt --write src",
-    "fmt:check": "oxfmt --check src",
-    "lint": "oxlint src",
-    "check": "bun run typecheck && bun run lint && bun run fmt:check"
+    "fmt": "oxfmt --write src bin",
+    "fmt:check": "oxfmt --check src bin",
+    "lint": "oxlint src bin",
+    "check": "bun run typecheck && bun run lint && bun run fmt:check",
+    "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"
@@ -409,7 +411,7 @@ export function App(props: AppProps = {}) {
   }
 
   const stageRow = () => (
-    <box flexDirection={compact() ? "column" : "row"} gap={0}>
+    <box flexDirection="row" gap={0}>
       {stageBadge("tailscale", "Tailscale")}
       {stageBadge("opencode", "OpenCode")}
       {stageBadge("publish", "Publish")}

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"]
+}