stage-tui 1.0.7

package/README.md

@@ -0,0 +1,112 @@
+# Stage [Beta]
+
+A calm, opinionated Git TUI.
+
+Inspired by GitHub Desktop. Built with OpenTUI.
+
+Stage keeps the core Git loop focused: review changes, stage with intent, commit clearly, and move on.
+
+What it does:
+
+- Diff-first workflow with per-file stage/unstage
+- Fast branch switching and commit history view
+- Optional AI-generated conventional commits
+
+<video src="https://github.com/user-attachments/assets/5f61e323-bb5e-4b11-9352-182d1a884feb" controls></video>
+
+## Get Started
+
+Prerequisite: [Bun](https://bun.sh)
+
+Install:
+
+```bash
+bun add -g stage-tui
+```
+
+Run:
+
+```bash
+stage
+```
+
+Debug with your local checkout from any repo:
+
+```bash
+export STAGE_DEV_PATH=/absolute/path/to/stage-tui
+stage --dev
+```
+
+## Use
+
+```bash
+stage            # use installed npm package
+stage --dev      # use local checkout at STAGE_DEV_PATH
+```
+
+## Configuration
+
+Config file path:
+
+- `${XDG_CONFIG_HOME:-~/.config}/stage-manager/config.toml`
+
+Stage creates this file on first launch.
+
+Optional overrides:
+
+- `STAGE_CONFIG=/path/to/config.toml`
+- `./.stage-manager.toml` (repo-local)
+
+Theme behavior:
+
+- `ui.theme = "auto"` follows OS appearance (default)
+- `ui.theme = "dark"` or `ui.theme = "light"` forces a mode
+
+<details>
+<summary>All Config Options (Defaults)</summary>
+
+```toml
+[ui]
+diff_view = "unified"                # "unified" | "split"
+theme = "auto"                       # "auto" | "dark" | "light"
+hide_whitespace_changes = true
+show_shortcuts_hint = true
+
+[history]
+limit = 200
+
+[git]
+auto_stage_on_commit = true
+
+[ai]
+enabled = false
+provider = "cerebras"                # currently only supported provider
+api_key = ""                         # required when enabled = true
+model = "gpt-oss-120b"
+reasoning_effort = "low"             # "low" | "medium" | "high"
+max_files = 32
+max_chars_per_file = 4000
+```
+
+</details>
+
+<details>
+<summary>Shortcuts</summary>
+
+- `?`: toggle shortcuts overlay
+- `b`: change branch
+- `h`: open commit history
+- `c`: open commit dialog (or AI auto-commit when enabled)
+- `space`: include/exclude selected file for commit
+- `↑ / ↓`: move file selection
+- `r`: refresh
+- `f`: fetch
+- `l`: pull
+- `p`: push
+- `esc`: close dialog (or exit from main view)
+
+</details>
+
+## Credits
+
+- Built with [OpenTUI](https://github.com/anomalyco/opentui)

package/bin/stage

@@ -0,0 +1,51 @@
+#!/usr/bin/env bun
+import { existsSync } from "node:fs"
+import { join, resolve } from "node:path"
+
+function resolveDevEntry(): string {
+  const envPath = process.env.STAGE_DEV_PATH
+  if (envPath) {
+    const entry = join(resolve(envPath), "index.ts")
+    if (existsSync(entry)) {
+      return entry
+    }
+
+    throw new Error(`STAGE_DEV_PATH does not contain index.ts: ${entry}`)
+  }
+
+  const cwdEntry = join(process.cwd(), "index.ts")
+  if (existsSync(cwdEntry)) {
+    return cwdEntry
+  }
+
+  throw new Error(
+    "stage --dev requires either STAGE_DEV_PATH=/absolute/path/to/stage-tui or running from the stage-tui repo root.",
+  )
+}
+
+async function runDevMode(args: string[]) {
+  const entry = resolveDevEntry()
+  const child = Bun.spawn(["bun", "run", entry, ...args], {
+    stdin: "inherit",
+    stdout: "inherit",
+    stderr: "inherit",
+  })
+
+  process.exit(await child.exited)
+}
+
+try {
+  const args = process.argv.slice(2)
+  const devModeIndex = args.indexOf("--dev")
+
+  if (devModeIndex >= 0) {
+    args.splice(devModeIndex, 1)
+    await runDevMode(args)
+  } else {
+    await import("../index.ts")
+  }
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error)
+  console.error(message)
+  process.exit(1)
+}

package/index.ts

@@ -0,0 +1,22 @@
+import React from "react"
+import { createCliRenderer } from "@opentui/core"
+import { createRoot } from "@opentui/react"
+
+import { App } from "./src/app"
+import { loadStageConfig } from "./src/config"
+
+const resolvedConfig = await loadStageConfig(process.cwd()).catch((error) => {
+  const message = error instanceof Error ? error.message : String(error)
+  console.error(`Failed to load stage config: ${message}`)
+  process.exit(1)
+})
+
+const renderer = await createCliRenderer({
+  targetFps: 30,
+  useMouse: true,
+  useConsole: false,
+  exitOnCtrlC: true,
+  onDestroy: () => process.exit(0),
+})
+
+createRoot(renderer).render(React.createElement(App, { config: resolvedConfig.config }))

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "stage-tui",
+  "version": "1.0.7",
+  "description": "Minimalist TUI Git client",
+  "author": "jenslys",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jenslys/stage.git"
+  },
+  "homepage": "https://github.com/jenslys/stage",
+  "bugs": {
+    "url": "https://github.com/jenslys/stage/issues"
+  },
+  "module": "index.ts",
+  "type": "module",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "bin",
+    "src",
+    "index.ts",
+    "README.md"
+  ],
+  "bin": {
+    "stage": "./bin/stage"
+  },
+  "scripts": {
+    "stage": "bun run index.ts"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/react": "^19.2.14"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "@ai-sdk/cerebras": "^2.0.34",
+    "@opentui/core": "^0.1.81",
+    "@opentui/react": "^0.1.81",
+    "ai": "^6.0.97",
+    "react": "^19.2.4"
+  }
+}