@gricha/perry 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Subroutine
+
+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,153 @@
+<p align="center">
+  <img src="assets/logo.png" alt="Perry" width="200">
+</p>
+
+<h1 align="center">Perry</h1>
+
+<p align="center">
+  <a href="https://github.com/gricha/perry/actions/workflows/test.yml"><img src="https://github.com/gricha/perry/actions/workflows/test.yml/badge.svg" alt="Tests"></a>
+  <a href="https://www.npmjs.com/package/@gricha/perry"><img src="https://badge.fury.io/js/@gricha%2Fperry.svg" alt="npm version"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
+</p>
+
+<p align="center">Isolated, self-hosted workspaces accessible over Tailscale. AI coding agents, web UI, and remote terminal access.</p>
+
+## Features
+
+- **AI Coding Agents** - Claude Code, OpenCode, GitHub Copilot pre-installed
+- **Self-Hosted** - Run on your own hardware, full control
+- **Remote Access** - Use from anywhere via Tailscale, CLI, web, or SSH
+- **Web UI** - Manage workspaces from your browser
+- **Isolated Environments** - Each workspace runs in its own container
+
+## Setup
+
+### Install
+
+```bash
+npm install -g @gricha/perry
+```
+
+### Build Base Image
+
+```bash
+perry build
+```
+
+### Start Agent
+
+```bash
+perry agent run
+```
+
+Web UI: **http://localhost:7391**
+
+The agent runs on port 7391 by default. For remote access, install as a service:
+
+```bash
+perry agent install
+systemctl --user start perry-agent
+```
+
+### Create & Use Workspaces
+
+**Via CLI:**
+
+```bash
+# Create workspace
+perry create myproject
+
+# Or clone a repo
+perry create myproject --clone git@github.com:user/repo.git
+
+# SSH into workspace
+perry list  # Find SSH port
+ssh -p 2201 workspace@localhost
+
+# Manage workspaces
+perry start myproject
+perry stop myproject
+perry delete myproject
+```
+
+**Via Web UI:**
+
+Open http://localhost:7391 and click "+" to create a workspace.
+
+## Security
+
+Perry is designed for use within **secure networks** like [Tailscale](https://tailscale.com). The web UI and API have no authentication, making them ideal for private networks where you can safely access workspaces remotely without additional security concerns.
+
+For public internet exposure, place behind a reverse proxy with authentication.
+
+## Configuration
+
+Configure credentials and environment variables via Web UI → Settings or edit `~/.config/perry/config.json`:
+
+```json
+{
+  "credentials": {
+    "env": {
+      "ANTHROPIC_API_KEY": "sk-ant-...",
+      "OPENAI_API_KEY": "sk-...",
+      "GITHUB_TOKEN": "ghp_..."
+    },
+    "files": {
+      "~/.ssh/id_ed25519": "~/.ssh/id_ed25519",
+      "~/.gitconfig": "~/.gitconfig"
+    }
+  }
+}
+```
+
+Restart workspaces to apply changes.
+
+## What's Inside Each Workspace
+
+- Ubuntu 24.04 LTS
+- Node.js 22, Python 3, Go
+- Docker (for containerized development)
+- Neovim + LazyVim
+- Git, GitHub CLI, ripgrep, fd-find, jq
+- Claude Code, OpenCode, Codex CLI
+
+## Commands
+
+```bash
+# Agent
+perry agent run [--port PORT]
+perry agent install
+perry agent uninstall
+perry agent status
+
+# Workspaces
+perry create <name> [--clone URL]
+perry start <name>
+perry stop <name>
+perry delete <name>
+perry list
+perry logs <name>
+
+# Build
+perry build [--no-cache]
+```
+
+## Development
+
+```bash
+git clone https://github.com/gricha/perry.git
+cd perry
+bun install
+bun run build
+```
+
+Run tests:
+
+```bash
+bun run validate  # Lint, typecheck, build, test
+bun run test      # Tests only
+```
+
+## License
+
+MIT

package/dist/agent/index.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+import { startAgent } from './run';
+startAgent().catch((err) => {
+    console.error('[agent] Fatal error:', err);
+    process.exit(1);
+});