@wkoutre/teamwork-os 1.0.0

package/LICENSE

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

@@ -0,0 +1,101 @@
+# TeamworkOS
+
+AI agent orchestration platform on your laptop.
+
+Run scheduled Claude Code agents, coordinate multi-agent teams, and manage everything through a live dashboard.
+
+## What is TeamworkOS
+
+TeamworkOS manages a hierarchy of AI employees (agents), schedules them as jobs, and routes work between them. You define agents in config files, write jobs that describe what each agent should do, and the platform runs them on a schedule. A live dashboard shows every running session, its output, and any messages sent between agents.
+
+Jobs connect to Slack, call tools, resume previous sessions, and coordinate through a shared identity layer. The gateway runs locally on your machine; agents use your own Claude Code subscription, so there are no per-token charges beyond what you already pay.
+
+## Prerequisites
+
+- **macOS 14+** or Linux (x86-64 or ARM)
+- **Node 22 (LTS)** (required): The published binary uses bytenode bytecode, which is V8-version-locked. A binary compiled for Node 22 cannot load on Node 25 or any other major version. Install via [nvm](https://github.com/nvm-sh/nvm): `nvm install 22 && nvm use 22`.
+- **Claude Code CLI**: Install from [claude.ai/download](https://claude.ai/download) and authenticate. TeamworkOS runs agents through the `claude` binary using your existing Claude Code subscription.
+- **Xcode Command Line Tools** (macOS, optional): Only needed if `better-sqlite3` lacks a prebuilt binary for your platform. Most users can skip this. If you see a build error during install, run `xcode-select --install` and retry.
+
+## Install
+
+```bash
+npm install -g @wkoutre/teamwork-os
+teamos init
+```
+
+`teamos init` is an interactive wizard that runs in about 60 seconds. It configures your environment and optionally starts the gateway as a background service.
+
+## First run
+
+`teamos init` walks through the following steps:
+
+1. **Checks your environment.** Node version and `claude` binary on PATH.
+2. **Creates `~/.teamwork/`.** The directory where all your data lives: jobs, agent definitions, logs, sessions, results. You can override the path by setting `TEAMWORK_HOME` before running `teamos init`.
+3. **Asks for optional API tokens.** Slack, Linear, Figma, GitHub. Each prompt shows one line describing what the token is for. Press Enter to skip any token; you can add them later by editing `~/.teamwork/.env`.
+4. **Confirms the port** (default: 7463). If the port is already taken by another process, the wizard will offer an available alternative.
+5. **Starts the gateway** and optionally installs it as a launchd (macOS) or systemd (Linux) service so it restarts automatically at login.
+6. **Prints a summary** with your dashboard URL and the most useful next commands.
+
+After setup, the dashboard is at `http://localhost:7463`.
+
+## Daily use
+
+```
+teamos status      Check whether the gateway is running and what's enabled.
+teamos restart     Bounce the gateway (picks up .env changes).
+teamos doctor      Health check: install mode, port, engine, and update availability.
+teamos update      Pull the latest version from npm and restart.
+teamos logs        Tail gateway logs.
+```
+
+## Updating
+
+`teamos update` is the recommended upgrade path. It handles the install, history recording, and gateway restart in one step.
+
+```bash
+teamos update                  # install latest, restart gateway
+teamos update --check          # exit 0 if up to date, exit 1 if an update is available
+teamos update --to 1.2.3       # pin to a specific version
+teamos update --rollback       # revert to the previously installed version
+```
+
+Alternatively: `npm install -g @wkoutre/teamwork-os@latest` followed by `teamos restart`.
+
+## Provenance verification
+
+All publishes use `--provenance`. You can verify that the package was built by the official CI pipeline (not from a stolen npm token) by running:
+
+```bash
+npm audit signatures @wkoutre/teamwork-os
+```
+
+This is optional. It confirms the supply-chain attestation attached to the release.
+
+## Uninstalling
+
+```bash
+teamos uninstall   # removes the launchd/systemd service; prompts before deleting ~/.teamwork/
+npm uninstall -g @wkoutre/teamwork-os
+```
+
+`teamos uninstall` will ask whether to also delete `~/.teamwork/` (your jobs, agent configs, logs, and sessions). The default is no. Pass `--remove-data` to opt in non-interactively.
+
+## Troubleshooting
+
+**Start with `teamos doctor`.** It checks the install mode, plist or systemd unit, port availability, engine configuration, and whether an update is available. Most issues surface there first.
+
+Common problems:
+
+- **Port 7463 in use:** `teamos init` will offer an alternate port during setup. To change it after the fact, set `PORT=XXXX` in `~/.teamwork/.env` and run `teamos restart`.
+- **`claude` not on PATH:** Confirm `which claude` works in a new terminal window. If you installed Claude Code recently, restart your shell or source your profile.
+- **EACCES on `npm install -g`:** Your global npm prefix may be system-owned. See [npm's EACCES docs](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally). Do not use `sudo npm install -g`.
+- **Gateway not starting:** Run `teamos doctor` for specifics. Logs are at `~/.teamwork/logs/gateway-launchd-error.log` (macOS) or via `journalctl --user -u teamwork-os` (Linux).
+
+## Reporting issues
+
+Public issue tracker coming soon. In the meantime, reach out to Nick directly if you hit a bug.
+
+## License
+
+[MIT](https://github.com/wkoutre/teamwork-os/blob/main/LICENSE)

package/cli.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+require('bytenode')
+require('./cli.jsc')

package/gateway.js

@@ -0,0 +1,2 @@
+require('bytenode')
+require('./gateway.jsc')

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@wkoutre/teamwork-os",
+  "version": "1.0.0",
+  "description": "AI agent orchestration platform.",
+  "license": "MIT",
+  "bin": {
+    "teamos": "./cli.js"
+  },
+  "main": "./cli.js",
+  "engines": {
+    "node": ">=25.0.0 <26"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "files": [
+    "cli.js",
+    "cli.jsc",
+    "gateway.js",
+    "gateway.jsc",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "better-sqlite3": "^12.8.0",
+    "sharp": "^0.34.5",
+    "sqlite-vec": "^0.1.9",
+    "@huggingface/transformers": "^4.0.1",
+    "@slack/bolt": "^4.7.0",
+    "bytenode": "1.5.7"
+  }
+}