sideye 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jimmy Guzman
+
+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,87 @@
+# sideye
+
+Keep a skeptical side-eye on your CLI coding agents. Run claude code, opencode, or codex in one terminal pane
+and `sideye` in the next — and stop opening an editor just to see **what is there, what is
+happening, and what is the difference**.
+
+Everything an IDE shows you, nothing it does for you. The "integrated" part is deliberately
+missing: your agent, your editor, and `sideye` stay decoupled. It never reviews, explains,
+approves, or talks back to an agent — you render judgment on the robot's output, then paste a
+`path:line` reference back into the agent conversation to redirect it in your own words.
+
+## Pillars
+
+- **The whole repo, with changes overlaid.** The full project tree renders like an IDE sidebar
+  (gitignore respected), changed files tinted and tagged, unchanged files quietly browsable.
+  Open any file read-only with syntax highlighting; open a changed file as a diff.
+- **Simple change scopes.** Cycle between all changes, staged only, and unstaged only with one
+  key — no restart, no flags to remember.
+- **Live, with activity awareness.** The view polls git while the agent works. Recently touched
+  files get a recency dot that decays, the status bar shows the last activity, and one key jumps
+  to whatever the agent just edited.
+- **Static analysis where an IDE would put it.** lint, tsc, and prettier findings show up as a
+  problems panel, inline line markers in the viewer, and per-file markers in the tree — anywhere
+  in the repo, not just changed files. Checks re-run automatically once the repo goes quiet.
+
+## Install
+
+```sh
+# standalone binary (macOS / Linux, no runtime needed)
+curl -fsSL https://raw.githubusercontent.com/jimmy-guzman/sideye/main/install.sh | bash
+
+# npm (works with npm, bun, pnpm, yarn — pulls a prebuilt binary)
+npm i -g sideye
+
+# homebrew
+brew install jimmy-guzman/tap/sideye
+```
+
+## Use it
+
+```sh
+sideye            # whole repo, worktree vs HEAD
+sideye main       # compare against another ref
+sideye --staged   # start in the staged scope
+sideye --unstaged # start in the unstaged scope
+```
+
+## Keys
+
+| Key         | Action                                          |
+| ----------- | ----------------------------------------------- |
+| `j` / `k`   | move in the tree, viewer, or problems panel     |
+| `h` / `l`   | collapse / expand folders                       |
+| `tab`       | switch focus between tree and viewer            |
+| `enter`     | open the focused item / jump to a problem       |
+| `ctrl-p`    | go to file: fuzzy-search the whole repo         |
+| `s`         | cycle scope: all changes → staged → unstaged    |
+| `c`         | toggle changes-only filter for the tree         |
+| `v`         | toggle diff ↔ full file view for a changed file |
+| `p`         | toggle the problems panel                       |
+| `.`         | jump to the most recently changed file          |
+| `n`         | jump to the next file with findings             |
+| `y`         | copy `path:line` + snippet at the cursor        |
+| `f`         | load full content when truncated                |
+| `r`         | re-run checks                                   |
+| `ctrl-d/u`  | half-page cursor movement in the viewer         |
+| `g` / `G`   | jump to first / last line                       |
+| `q` / `esc` | quit (esc closes the problems panel first)      |
+
+## Requirements
+
+- git
+- macOS for clipboard copy (`pbcopy`) in v1
+
+## Development
+
+```sh
+bun install
+bun run src/main.tsx     # run from source
+bun run check            # tests + typecheck
+bun run build:dist       # build standalone binaries for all targets
+```
+
+## What it will not do
+
+No AI integration, no gating, no accept/reject protocol, no generated review explanations.
+The agent never hears from `sideye` — only from you.

package/bin/sideye.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+
+// npm launcher: resolves the platform-specific sideye binary package and execs it.
+// Pattern from opencode's bin launcher (anomalyco/opencode packages/opencode/bin/opencode).
+
+const childProcess = require("node:child_process")
+const fs = require("node:fs")
+const path = require("node:path")
+const os = require("node:os")
+
+const forwardedSignals = ["SIGINT", "SIGTERM", "SIGHUP"]
+
+function run(target) {
+  const child = childProcess.spawn(target, process.argv.slice(2), { stdio: "inherit" })
+
+  child.on("error", (error) => {
+    console.error(error.message)
+    process.exit(1)
+  })
+
+  for (const signal of forwardedSignals) {
+    process.on(signal, () => {
+      try {
+        child.kill(signal)
+      } catch {
+        // the child may have already exited
+      }
+    })
+  }
+
+  child.on("exit", (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal)
+      return
+    }
+    process.exit(code === null ? 1 : code)
+  })
+}
+
+const packageName = `sideye-${os.platform()}-${os.arch()}`
+
+function findBinary(startDir) {
+  let current = startDir
+  for (;;) {
+    const candidate = path.join(current, "node_modules", packageName, "bin", "sideye")
+    if (fs.existsSync(candidate)) {
+      return candidate
+    }
+
+    const parent = path.dirname(current)
+    if (parent === current) {
+      return undefined
+    }
+    current = parent
+  }
+}
+
+const resolved = process.env.SIDEYE_BIN_PATH || findBinary(__dirname)
+
+if (!resolved) {
+  console.error(
+    `Could not find the sideye binary for your platform. Your package manager may have skipped optional dependencies; try reinstalling, or install "${packageName}" directly. Supported platforms: darwin/linux on arm64/x64.`,
+  )
+  process.exit(1)
+}
+
+run(resolved)

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "sideye",
+  "version": "0.1.3",
+  "description": "Read-only companion TUI for CLI coding agents",
+  "repository": "github:jimmy-guzman/sideye",
+  "homepage": "https://github.com/jimmy-guzman/sideye",
+  "bugs": "https://github.com/jimmy-guzman/sideye/issues",
+  "keywords": [
+    "tui",
+    "diff",
+    "git",
+    "code-review",
+    "coding-agent",
+    "terminal"
+  ],
+  "license": "MIT",
+  "bin": {
+    "sideye": "./bin/sideye.js"
+  },
+  "optionalDependencies": {
+    "sideye-darwin-arm64": "0.1.3",
+    "sideye-darwin-x64": "0.1.3",
+    "sideye-linux-x64": "0.1.3",
+    "sideye-linux-arm64": "0.1.3"
+  }
+}