hmanlab 0.1.2

package/README.md

@@ -0,0 +1,47 @@
+# hmanlab
+
+A terminal UI for chatting with local [Ollama](https://ollama.com) models — plus BYOK providers (z.ai, Ollama Cloud, OpenCode Go) — built in Rust with [ratatui](https://ratatui.rs).
+
+```bash
+# Global install
+npm install -g hmanlab
+
+# Run once without installing
+npx hmanlab
+
+# Per-project (e.g. add to a repo's dev deps)
+npm install --save-dev hmanlab
+npx hmanlab
+```
+
+## Features
+
+- Streaming replies, agentic tool calls (`read_file`, `edit_file`, `run_command`, git, find), foldable `<think>` blocks
+- BYOK providers: z.ai (subscription + usage), Ollama Cloud, OpenCode Go
+- Session persistence via `hmanlab-api`, with `/sessions`, `/load`, `/more`
+- Workspace sidebar with click-to-expand folders, scroll, click-to-open file viewer
+- `/compact` slash command + automatic compaction at high context tokens; compactions are persisted to `<workspace>/.hmanlab/memory/compact-current.md` so the model can resume across sessions
+- Memory store at `~/.hmanlab/memory/` (user-scope) and `<workspace>/.hmanlab/memory/` (project-scope), surfaced to the model every turn
+
+## Supported platforms
+
+Prebuilt binaries ship for:
+
+- `linux-x64`, `linux-arm64` (musl, statically-linked)
+- `darwin-x64`, `darwin-arm64`
+- `win32-x64`
+
+On other platforms, `npm install` will succeed but `hmanlab` will print a friendly "no prebuilt binary" message and exit. Build from source via `cargo install --git https://github.com/rekabytes/hmanlab`.
+
+## Where does `.hmanlab/` live?
+
+Wherever you launch `hmanlab` from — that becomes the **workspace**:
+
+- Project install: `npx hmanlab` from a project dir → `<project>/.hmanlab/`
+- Global install: `cd ~/myrepo && hmanlab` → `~/myrepo/.hmanlab/`. `cd ~ && hmanlab` → `~/.hmanlab/`
+
+User-scope state (cross-project preferences, identity) always lives at `~/.hmanlab/`.
+
+## License
+
+MIT. See https://github.com/rekabytes/hmanlab for source.

package/bin/hmanlab.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+// hmanlab launcher. Resolves the matching prebuilt binary from the
+// per-arch optional dependency and execs it with the user's args. The
+// binary itself is a self-contained Rust executable — this shim just
+// figures out which one to run and forwards stdio + signals.
+
+'use strict';
+
+const { spawn } = require('node:child_process');
+
+const { platform, arch } = process;
+// npm normalises win32 platforms to 'win32', x64/arm64 are already the
+// arch names we use in the subpackage names — match them 1:1.
+const pkg = `@hmanlab/${platform}-${arch}`;
+const exe = platform === 'win32' ? 'hmanlab.exe' : 'hmanlab';
+
+let binPath;
+try {
+  binPath = require.resolve(`${pkg}/bin/${exe}`);
+} catch (e) {
+  console.error(
+    `hmanlab: no prebuilt binary for ${platform}-${arch}.\n` +
+    'Supported platforms: linux-x64, linux-arm64, darwin-x64, darwin-arm64, win32-x64.\n' +
+    'Install Rust and build from source: https://github.com/rekabytes/hmanlab'
+  );
+  process.exit(1);
+}
+
+const child = spawn(binPath, process.argv.slice(2), { stdio: 'inherit' });
+
+// Forward signals to the child so Ctrl+C in the parent shell shuts down
+// the TUI cleanly instead of orphaning it with a half-painted terminal.
+for (const sig of ['SIGINT', 'SIGTERM', 'SIGHUP', 'SIGQUIT']) {
+  process.on(sig, () => {
+    try { child.kill(sig); } catch (_) { /* child already gone */ }
+  });
+}
+
+child.on('error', (err) => {
+  console.error(`hmanlab: failed to launch binary (${binPath}): ${err.message}`);
+  process.exit(1);
+});
+
+child.on('exit', (code, signal) => {
+  // If the child died by signal, re-raise it on ourselves so the parent
+  // shell's exit-code reporting (e.g. 130 for SIGINT) stays consistent
+  // with running the native binary directly.
+  if (signal) {
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code ?? 0);
+  }
+});

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "hmanlab",
+  "version": "0.1.2",
+  "description": "hmanlab — a terminal UI for chatting with Ollama, z.ai, Ollama Cloud, and OpenCode Go from your shell.",
+  "keywords": [
+    "ai",
+    "agent",
+    "ollama",
+    "tui",
+    "terminal",
+    "rust",
+    "llm"
+  ],
+  "homepage": "https://github.com/rekabytes/hmanlab",
+  "bugs": {
+    "url": "https://github.com/rekabytes/hmanlab/issues"
+  },
+  "license": "MIT",
+  "author": "rekabytes <hello@rekabytes.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rekabytes/hmanlab.git"
+  },
+  "bin": {
+    "hmanlab": "bin/hmanlab.js"
+  },
+  "files": [
+    "bin/hmanlab.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@hmanlab/linux-x64": "0.1.2",
+    "@hmanlab/linux-arm64": "0.1.2",
+    "@hmanlab/darwin-x64": "0.1.2",
+    "@hmanlab/darwin-arm64": "0.1.2",
+    "@hmanlab/win32-x64": "0.1.2"
+  }
+}