@rifuki/negi 0.0.0-stage → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rifuki
+
+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,83 @@
-# Temporary Holding Version
+<p align="center">
+  <img src="docs/media/negi.webp" width="200" alt="Miku holding a phone and a green onion">
+</p>
 
-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.
+<h1 align="center">negi</h1>
+
+<p align="center">tmux and your Mac's screen, on your phone.</p>
+
+<p align="center">
+  <a href="https://github.com/rifuki/negi/releases/latest"><img src="https://img.shields.io/github/v/release/rifuki/negi?color=39c5bb" alt="Latest release"></a>
+  <a href="https://crates.io/crates/negi"><img src="https://img.shields.io/crates/v/negi?color=39c5bb" alt="crates.io"></a>
+  <a href="https://www.npmjs.com/package/@rifuki/negi"><img src="https://img.shields.io/npm/v/@rifuki/negi?color=39c5bb" alt="npm"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/github/license/rifuki/negi?color=39c5bb" alt="MIT"></a>
+</p>
+
+<p align="center">
+  <img src="docs/media/demo.webp" width="300" alt="An agent in tmux asks to run the tests; the answer is typed from the phone and the tests pass">
+</p>
+
+Your agent stops to ask a question while you are away from the desk. Open negi on your
+phone, read the pane, answer it, and it carries on. One Rust binary on your Mac serves
+the page over your tailnet; nothing goes through anyone else's server.
+
+## What it does
+
+- Every tmux session, window and pane on your phone, live, with the colours your
+  programs print.
+- Type into a pane, with a key row for esc, tab, ctrl, option, command and the arrows.
+- Answer an agent's prompt, scroll back through a pane, send a file into it.
+- See and drive the Mac's own screen as live video, with touch as a trackpad.
+- The Mac's battery and Wi-Fi at a glance, and a speed test of the link to it. While a
+  phone is connected the Mac does not sleep for idleness (closing the lid still sleeps it).
+
+<p align="center">
+  <img src="docs/media/screens.webp" alt="Pairing, the session list, an agent's pane, and the settings">
+</p>
+
+## Install
+
+```sh
+brew install rifuki/tap/negi
+```
+
+or `npm install -g @rifuki/negi`, or `cargo install negi`. macOS 12.3 or later on Apple silicon; on an Intel Mac, `cargo install negi` builds it.
+
+## Get started
+
+With [Tailscale](https://tailscale.com) signed in on the Mac and on the phone:
+
+```sh
+negi serve      # keep it running; brew services start negi does it at login
+negi tailnet    # serves it on your tailnet and prints its https address
+negi pair       # open that address on the phone and type the code it shows
+```
+
+On the phone, Share, Add to Home Screen (or Install app on Android) opens negi full screen
+like an app, and it still opens when the Mac is out of reach.
+
+The screen comes as live video from negi itself. macOS asks once for Screen Recording
+(to see it) and Accessibility (to drive it), for negi or the terminal it runs in. Without
+them negi falls back to Screen Sharing (System Settings, General, Sharing), which asks for
+your Mac login.
+
+## Safe by default
+
+- Other devices reach it only through your tailnet, and only signed in as you.
+- Each phone pairs once with a one-time code that `negi pair` takes back on Ctrl+C;
+  `negi revoke` unpairs it.
+- Keys are stored hashed; a kept screen login is sealed by the server for one device.
+- Before live video shows the screen or takes input, each phone gives the Mac's password
+  once. macOS checks it; negi does not keep it, and five wrong tries lock that phone out
+  for five minutes.
+
+[How it works](docs/SPEC.md) · [Development](docs/DEVELOPMENT.md)
+
+## License
+
+MIT for the code.
+
+Hatsune Miku is a character of Crypton Future Media, INC., used here non-commercially
+under the [Piapro Character License](https://piapro.net/intl/en_for_creators.html).
+© Crypton Future Media, INC. www.piapro.net. The drawings of her were made for negi and
+are not covered by the MIT licence.

package/package.json

@@ -1,6 +1,13 @@
 {
   "name": "@rifuki/negi",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.1",
+  "description": "tmux and your Mac's screen, on your phone, over your tailnet.",
+  "license": "MIT",
+  "homepage": "https://github.com/rifuki/negi",
+  "repository": { "type": "git", "url": "git+https://github.com/rifuki/negi.git" },
+  "keywords": ["tmux", "terminal", "remote", "phone", "tailscale", "vnc"],
+  "bin": { "negi": "bin/negi" },
+  "files": ["bin/negi", "README.md", "LICENSE"],
+  "os": ["darwin"],
+  "cpu": ["arm64"]
+}