tarcsweb 0.0.0-stage → 0.5.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tlucas97
+
+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

@@ -1,3 +1,13 @@
-# Temporary Holding Version
+# tarcsweb
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Claude Code and Codex in one browser tab, running on your own computer.
+
+```sh
+npx tarcsweb
+```
+
+This package is the installer. It downloads the latest tarcsweb release from GitHub into `~/.local/share/tarcsweb`, builds it there and runs it as a background service on http://localhost:24816. Running it again updates to the latest release. It works on Linux with a systemd user session, on macOS and on Windows through WSL2.
+
+`npx tarcsweb v0.5.1` installs a given version, and `npx tarcsweb --yes` answers yes to the installer's questions.
+
+Requirements, screenshots and the uninstall command are in the [README on GitHub](https://github.com/TLucas97/tarcsweb#readme).

package/bin/tarcsweb.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+// Installs or updates tarcsweb with the get.sh packed next to it; arguments go to get.sh (a version, --yes, --help).
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+if (process.platform === 'win32') {
+  console.error(
+    [
+      'tarcsweb does not run on Windows directly yet. Install it inside WSL2:',
+      '  1. In PowerShell:  wsl --install -d Ubuntu',
+      '  2. In the Ubuntu terminal, with Node installed:  npx tarcsweb',
+      'Then open http://localhost:24816 in your Windows browser.',
+      'More in the README: https://github.com/TLucas97/tarcsweb#install',
+    ].join('\n'),
+  );
+  process.exit(1);
+}
+
+const getSh = fileURLToPath(new URL('../get.sh', import.meta.url));
+const run = spawnSync('bash', [getSh, ...process.argv.slice(2)], { stdio: 'inherit' });
+if (run.error) {
+  console.error(run.error.code === 'ENOENT' ? 'tarcsweb needs bash to install' : run.error.message);
+  process.exit(1);
+}
+process.exit(run.status ?? 1);

package/get.sh

@@ -0,0 +1,106 @@
+#!/usr/bin/env bash
+# Installs or updates tarcsweb from a GitHub release, without git, on Linux or macOS. Safe to re-run; bash 3.2 compatible.
+#   curl -fsSL https://raw.githubusercontent.com/TLucas97/tarcsweb/main/get.sh | bash
+#   bash get.sh [version] [--yes]      e.g. bash get.sh v0.1.1
+# Env: TARCSWEB_HOME (install root), TARCSWEB_API (release API base), and install.sh's own (TARCSWEB_PORT, ...).
+set -euo pipefail
+
+REPO_SLUG="TLucas97/tarcsweb"
+
+API="${TARCSWEB_API:-https://api.github.com}"
+HOME_DIR="${TARCSWEB_HOME:-${XDG_DATA_HOME:-$HOME/.local/share}/tarcsweb}"
+RELEASES="$HOME_DIR/releases"
+TMP=""
+
+say() { printf '\n==> %s\n' "$*" >&2; }
+die() { printf 'error: %s\n' "$*" >&2; exit 1; }
+cleanup() { [ -z "$TMP" ] || rm -rf "$TMP"; }
+
+usage() {
+  cat >&2 << EOF
+Usage: get.sh [version] [--yes]
+Installs the latest tarcsweb release (or the given version) into $HOME_DIR.
+  version     a release tag such as v0.1.1 (default: the latest release)
+  --yes, -y   answer yes to install.sh's questions (Node, pnpm, voice)
+EOF
+}
+
+# First string value of a JSON key; works on compact and pretty-printed JSON.
+json_str() {
+  { grep -o "\"$1\": *\"[^\"]*\"" || true; } | head -n 1 | sed 's/^"[^"]*": *"\(.*\)"$/\1/'
+}
+
+# Prints the release JSON for "latest" or a tag.
+fetch_release() {
+  local url out code
+  if [ "$1" = latest ]; then url="$API/repos/$REPO_SLUG/releases/latest"; else url="$API/repos/$REPO_SLUG/releases/tags/$1"; fi
+  out="$(curl -sSL --max-time 30 -H 'Accept: application/vnd.github+json' -w '\n%{http_code}' "$url")" || die "could not reach $API (are you offline?)"
+  code="${out##*$'\n'}"
+  case "$code" in
+    200) printf '%s' "${out%$'\n'*}" ;;
+    404) if [ "$1" = latest ]; then die "$REPO_SLUG has no published release yet"; else die "release $1 not found in $REPO_SLUG"; fi ;;
+    403 | 429) die "GitHub's API rate limit was reached; try again in an hour" ;;
+    *) die "GitHub's API answered HTTP $code for $url" ;;
+  esac
+}
+
+# Wrapped in a function so `curl | bash` reads the whole script before running any of it.
+main() {
+  local want=latest fetch_only=0 arg
+  local pass=()
+  for arg in "$@"; do
+    case "$arg" in
+      -h | --help) usage; return 0 ;;
+      -y | --yes) pass+=("--yes") ;;
+      --fetch-only) fetch_only=1 ;;
+      -*) usage; die "unknown option $arg" ;;
+      *) want="v${arg#v}" ;;
+    esac
+  done
+
+  case "$(uname -s)" in
+    Linux | Darwin) ;;
+    *) die "tarcsweb supports Linux and macOS only" ;;
+  esac
+  for arg in curl tar gzip; do command -v "$arg" > /dev/null || die "$arg is required"; done
+
+  say "Looking up the $want release of $REPO_SLUG"
+  local json tag tarball
+  json="$(fetch_release "$want")"
+  tag="$(printf '%s' "$json" | json_str tag_name)"
+  [[ "$tag" =~ ^v[0-9]+\.[0-9]+\.[0-9]+([-+][0-9A-Za-z.-]+)?$ ]] || die "unexpected release tag '$tag'"
+  tarball="$(printf '%s' "$json" | json_str tarball_url)"
+  [[ "$tarball" =~ ^https?:// ]] || tarball="https://github.com/$REPO_SLUG/archive/refs/tags/$tag.tar.gz"
+  echo "release $tag" >&2
+
+  local dest="$RELEASES/$tag"
+  if [ -f "$dest/.tarcsweb-release" ]; then
+    echo "already downloaded in $dest" >&2
+  else
+    say "Downloading $tag"
+    mkdir -p "$RELEASES"
+    TMP="$(mktemp -d "$RELEASES/.get-XXXXXX")"
+    trap cleanup EXIT
+    curl -fSL --retry 3 --max-time 600 -o "$TMP/src.tar.gz" "$tarball" || die "download of $tarball failed"
+    mkdir "$TMP/src"
+    tar -xzf "$TMP/src.tar.gz" -C "$TMP/src" --strip-components=1 --no-same-owner || die "could not extract the release archive"
+    [ -f "$TMP/src/package.json" ] && [ -f "$TMP/src/install.sh" ] || die "the archive does not look like tarcsweb"
+    # Marks a finished extraction; install.sh and the server read it to know this is a release install.
+    printf '%s\n' "$tag" > "$TMP/src/.tarcsweb-release"
+    rm -rf "$dest"
+    mv "$TMP/src" "$dest"
+    echo "extracted into $dest" >&2
+  fi
+
+  if [ "$fetch_only" = 1 ]; then
+    printf '%s\n' "$dest"
+    return 0
+  fi
+
+  # install.sh builds inside the release dir, then points $HOME_DIR/current at it and restarts the service.
+  say "Running $tag's install.sh"
+  # Bash 3.2 (macOS) treats "${pass[@]}" of an empty array as unbound under set -u.
+  TARCSWEB_HOME="$HOME_DIR" bash "$dest/install.sh" ${pass[@]+"${pass[@]}"} < /dev/null
+}
+
+main "$@"

package/package.json

@@ -1,6 +1,24 @@
 {
   "name": "tarcsweb",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.5.1",
+  "description": "Installs tarcsweb, Claude Code and Codex in one browser tab, as a background service on Linux, macOS or WSL2",
+  "keywords": ["claude-code", "codex", "web-ui", "agents"],
+  "license": "MIT",
+  "homepage": "https://github.com/TLucas97/tarcsweb#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TLucas97/tarcsweb.git",
+    "directory": "npm"
+  },
+  "type": "module",
+  "bin": {
+    "tarcsweb": "bin/tarcsweb.js"
+  },
+  "files": ["bin", "get.sh"],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "prepack": "cp ../get.sh ../LICENSE ."
+  }
+}