junis 0.1.0

package/README.md

@@ -0,0 +1,162 @@
+# junis
+
+[![npm version](https://img.shields.io/npm/v/junis)](https://www.npmjs.com/package/junis)
+[![license](https://img.shields.io/npm/l/junis)](./LICENSE)
+
+Full device control for AI agents via MCP. Run a local MCP server or connect to the cloud so any AI agent can execute commands, manage files, control browsers, and more on your machine.
+
+---
+
+## Features
+
+- **Zero-config local mode** — `npx junis --local` and you're live
+- **Cloud relay mode** — connect via `wss://api.junis.ai` for remote access
+- **File & shell tools** — read, write, search, execute, manage processes
+- **Browser automation** — navigate, click, type, screenshot, PDF via Playwright
+- **MCP-native** — works with Claude Code, Claude Desktop, and any MCP client
+- **TypeScript** — built on `@modelcontextprotocol/sdk`
+
+---
+
+## Quick Start
+
+### Local Mode (no account required)
+
+```bash
+npx junis --local
+```
+
+Starts an MCP server on `http://localhost:3000`. Point your MCP client at it and start using tools immediately.
+
+### Cloud Mode
+
+```bash
+npx junis
+```
+
+On first run, opens a browser for OAuth login. After authentication, your device connects to `wss://api.junis.ai` and is ready for remote AI agent sessions.
+
+---
+
+## CLI Reference
+
+```
+Usage: npx junis [options] [command]
+
+Options:
+  --local           Run MCP server locally without cloud authentication
+  --port <port>     Port for local MCP server (default: 3000)
+  --reset           Reset saved credentials and re-authenticate
+
+Commands:
+  logout            Remove stored credentials
+  status            Show current connection and device status
+```
+
+### Examples
+
+```bash
+# Start local MCP server on default port
+npx junis --local
+
+# Start local MCP server on custom port
+npx junis --local --port 8080
+
+# Re-authenticate (clear saved token)
+npx junis --reset
+
+# Check connection status
+npx junis status
+
+# Log out
+npx junis logout
+```
+
+---
+
+## Tools
+
+### File & Shell
+
+| Tool | Description |
+|------|-------------|
+| `execute_command` | Run shell commands and return stdout/stderr |
+| `read_file` | Read file contents |
+| `write_file` | Write or overwrite a file |
+| `list_directory` | List files and directories |
+| `search_code` | Search for text patterns across files |
+| `list_processes` | List running processes |
+| `kill_process` | Kill a process by PID |
+
+### Browser (requires Playwright)
+
+| Tool | Description |
+|------|-------------|
+| `browser_navigate` | Navigate to a URL |
+| `browser_click` | Click an element by selector |
+| `browser_type` | Type text into an input |
+| `browser_screenshot` | Take a screenshot of the page |
+| `browser_snapshot` | Capture DOM snapshot for accessibility |
+| `browser_evaluate` | Execute JavaScript in the page |
+| `browser_pdf` | Save the page as a PDF |
+
+> Playwright is optional. If not installed, browser tools emit a warning instead of crashing.
+
+### Notebook (requires Jupyter)
+
+| Tool | Description |
+|------|-------------|
+| `notebook_read` | Read Jupyter notebook cells |
+| `notebook_edit_cell` | Edit a specific cell in a notebook |
+| `notebook_execute` | Execute notebook via nbconvert |
+
+> Install Jupyter: `pip install jupyter`
+
+### Device (macOS / Linux / Windows)
+
+| Tool | Description |
+|------|-------------|
+| `screen_capture` | Capture a screenshot using OS native tools |
+| `camera_capture` | Take a photo using the webcam |
+| `notification_send` | Send an OS notification |
+| `clipboard_read` | Read clipboard contents |
+| `clipboard_write` | Write text to clipboard |
+
+> macOS: `brew install imagesnap` for camera capture
+
+---
+
+## Claude Code Integration
+
+Register junis as a stdio MCP server so Claude Code can launch it automatically:
+
+```bash
+claude mcp add junis node /Users/leehyeonjin/development/junis-mcp/dist/server/stdio.js
+```
+
+After registration, Claude Code will start junis automatically and have access to all tools without any manual server startup.
+
+---
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `JUNIS_API_URL` | `https://api.junis.ai` | REST API base URL |
+| `JUNIS_WS_URL` | `wss://api.junis.ai` | WebSocket relay URL |
+| `JUNIS_WEB_URL` | `https://junis.ai` | Web UI URL (used during OAuth) |
+
+---
+
+## Requirements
+
+- Node.js >= 18
+- (Optional) Playwright for browser tools: `npx playwright install chromium`
+- (Optional) Jupyter for notebook tools: `pip install jupyter`
+- (Optional) imagesnap for camera capture (macOS): `brew install imagesnap`
+
+---
+
+## License
+
+MIT

package/dist/cli/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node