@agentrific/server 0.1.0 → 0.1.4

package/CHANGELOG.md

@@ -0,0 +1,25 @@
+# @agentrific/server
+
+## 0.1.4
+
+### Patch Changes
+
+- 25de50c: Include the GitHub pull request URL in task responses after successful pull request delivery so updated clients can show Open PR on completed task cards.
+
+## 0.1.3
+
+### Patch Changes
+
+- 0f911cb: Encode pairing QR codes as `agentrific://pair` links so supported phone camera apps can open Agentrific with the invitation filled in. Keep the PIN separate and hide the manual JSON payload until requested with **j** or `pair --show-payload`. Older app versions can still use JSON manual entry. Pairing-link scanning requires an updated Agentrific app.
+
+## 0.1.2
+
+### Patch Changes
+
+- 72e68ad: Upgrade the embedded Pi SDK to 1.0.0 so Agentrific automatically recognizes existing credentials saved by both Pi v0 and v1, including the newer OpenAI ChatGPT login. Add real SDK integration tests for startup credential discovery, legacy credentials and transcripts, sessions, streaming, tools, model selection, attachments and delivery, with an isolated compatibility check for future Pi releases.
+
+## 0.1.1
+
+### Patch Changes
+
+- f730c2e: Publish the compiled server CLI to npm with automated versioning and release notes.

package/README.md

@@ -1,8 +1,24 @@
-# @agentrific/server
+# Agentrific Server
 
-Agentrific is a self-hosted control plane for long-running coding agents. This package provides its server and the `agentrific` command-line tool for macOS and Linux.
+Run coding agents on your computer or server, and control them from the Agentrific iOS and Android apps. Start work, follow progress, send instructions and review results from your phone while the agents run on your own machine.
 
-Install Node.js 22.19 or newer, Git, and [Pi](https://pi.dev/). Connect your model accounts through Pi using the same OS account that will run the server.
+This package installs the Agentrific server and the `agentrific` command-line tool for macOS and Linux. The mobile apps connect to your server; your repositories, model accounts and agent processes stay on that machine. A paired device can disconnect and reconnect without ending a running agent session.
+
+With Agentrific you can:
+
+- Manage tasks and agent sessions across your Git repositories.
+- Run coding tasks in separate Git worktrees.
+- Follow live progress and send follow-up instructions from your phone.
+- Attach images and files to give agents context.
+- Pair multiple devices with the same server and revoke access when needed.
+
+Learn more at [agentrific.com](https://agentrific.com).
+
+## Install and start
+
+You'll need Node.js 22.19 or newer, Git, and [Pi](https://pi.dev/) on the machine that will run your agents. Install Pi and connect your model accounts using the same OS account that will run the server. See the [model setup guide](https://agentrific.com/docs/pi-model-setup).
+
+Before installing the server, install your chosen tunnel provider: Tailscale on the server and phone, or `cloudflared` on the server. You can also use an existing HTTPS tunnel or reverse proxy. Agentrific does not install these tools for you. See the [connection setup guide](https://agentrific.com/docs/secure-server-setup#choose-an-https-connection).
 
 ```sh
 npm install -g @agentrific/server
@@ -10,8 +26,26 @@ agentrific init
 agentrific start
 ```
 
-Run `agentrific --help` for commands. The server defaults to port 4318 and stores its configuration and state in `~/.agentrific`. Its initial projects folder is `~/projects`.
+The server defaults to port 4318 and stores its configuration and state in `~/.agentrific`. Its initial projects folder is `~/projects`; you can choose a different folder in the app's server settings.
+
+## Connect your phone
+
+Open the Agentrific app on iOS or Android. In the server terminal, choose Tailscale Serve, Cloudflare Tunnel, or an existing HTTPS endpoint, then press **p** to display a pairing QR code. Scan it in the app and enter the separately printed six-digit PIN.
+
+Once paired, select a project, create a task and start an agent. The server runs the work and streams progress back to your device. Use HTTPS for remote connections; your phone must be able to reach the configured server address.
+
+See the [server setup and pairing guide](https://agentrific.com/docs/secure-server-setup) for connection options and configuration.
+
+## Useful commands
+
+```sh
+agentrific --help          # Show commands and options
+agentrific status         # Show server status
+agentrific pair           # Print a fresh pairing QR code and PIN
+agentrific devices        # List paired devices
+agentrific update --check # Check for a newer server release
+```
 
-Use HTTPS through Tailscale Serve, Cloudflare Tunnel, or an existing HTTPS endpoint when connecting remotely. In the server terminal, choose a connection and press **p** to display a pairing QR code. Pair your Agentrific client with the QR code and the separately printed six-digit PIN.
+## Access and permissions
 
 Devices must pair before accessing server commands and events. Coding agents execute with the server user's permissions, so run the server under an account with access only to the repositories and credentials you intend to use.