@runtypelabs/cli 0.1.0

package/README.md

@@ -0,0 +1,182 @@
+# Runtype CLI
+
+Command-line interface for the Runtype AI platform.
+
+## Installation
+
+```bash
+npm install -g @runtypelabs/cli
+```
+
+## Quick Start
+
+### 1. Create Account & Authenticate
+
+```bash
+# Create a new account
+runtype auth signup
+
+# Or login to existing account
+runtype auth login
+
+# Check authentication status
+runtype auth whoami
+```
+
+### 2. Start Interactive Chat
+
+```bash
+# Start a chat session
+runtype talk
+
+# With custom model
+runtype talk --model claude-3-opus --temperature 0.2
+
+# With system prompt
+runtype talk --system "You are an expert in Next.js development"
+```
+
+### 3. Manage Flows and Records
+
+```bash
+# List flows
+runtype flows list
+
+# Run a flow
+runtype flows run <flow-id> --record <record-id>
+
+# Create a record
+runtype records create --name "My Record" --type "document"
+
+# List records
+runtype records list --type document
+```
+
+## Chat Commands
+
+During a chat session, you can use these special commands:
+
+- `/help` - Show available commands
+- `/clear` - Clear conversation history
+- `/save [filename]` - Save session to file
+- `/load <filename>` - Load session from file
+- `/export` - Export conversation as markdown
+- `/model <model>` - Change AI model
+- `/temp <value>` - Set temperature (0-1)
+- `/info` - Show session information
+- `/exit` - Exit chat session
+
+## Configuration
+
+```bash
+# View all configuration
+runtype config get
+
+# Set API URL
+runtype config set apiUrl https://api.runtype.com
+
+# Set default model
+runtype config set defaultModel gpt-4o
+
+# Reset configuration
+runtype config reset
+```
+
+## Development
+
+### Local Development Setup
+
+```bash
+# From repository root, navigate to CLI package
+cd packages/cli
+
+# Install dependencies
+pnpm install
+
+# Copy environment template and configure for local development
+cp .env.example .env
+# Edit .env with your local settings (API URL, Clerk key, etc.)
+
+# Build the CLI
+pnpm build
+```
+
+### Running the CLI Locally
+
+**Option 1: Development mode with hot reload**
+```bash
+# Run with tsx watch (for development)
+pnpm dev
+
+# Run specific commands in dev mode
+pnpm dev -- --help
+pnpm dev -- auth login
+pnpm dev -- config get
+```
+
+**Option 2: Build and run directly**
+```bash
+# Build first
+pnpm build
+
+# Run built CLI with Node.js
+node dist/index.js --help
+node dist/index.js auth login
+node dist/index.js talk
+```
+
+**Option 3: Install globally for testing**
+```bash
+# Build and install globally
+pnpm build
+npm install -g .
+
+# Now use the runtype command anywhere
+runtype --help
+runtype auth login
+runtype talk
+
+# After making changes, rebuild and reinstall
+pnpm build && npm install -g .
+```
+
+### Local Environment Configuration
+
+Create a `.env` file for local development:
+
+```bash
+# Point to local API and dashboard
+RUNTYPE_API_URL=http://localhost:8787
+RUNTYPE_DASHBOARD_URL=http://localhost:3001
+
+# Add your Clerk publishable key (get from Clerk dashboard)
+CLERK_PUBLISHABLE_KEY=pk_test_your_key_here
+
+# Optional: Set defaults
+RUNTYPE_DEFAULT_MODEL=meta/llama3.1-8b-instruct-free
+RUNTYPE_DEFAULT_TEMPERATURE=0.7
+DEBUG=true
+```
+
+### Testing
+
+```bash
+# Run tests
+pnpm test
+
+# Watch mode
+pnpm test:watch
+```
+
+## Environment Variables
+
+- `RUNTYPE_API_URL` - API endpoint URL (default: https://api.runtype.com)
+- `RUNTYPE_DASHBOARD_URL` - Dashboard URL (default: https://dashboard.runtype.com)
+- `CLERK_PUBLISHABLE_KEY` - Clerk public key for OAuth
+- `RUNTYPE_DEFAULT_MODEL` - Default AI model (default: gpt-4o)
+- `RUNTYPE_DEFAULT_TEMPERATURE` - Default temperature (default: 0.7)
+- `DEBUG` - Enable debug mode
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@runtypelabs/cli",
+  "version": "0.1.0",
+  "description": "Command-line interface for Runtype AI platform",
+  "main": "dist/index.js",
+  "bin": {
+    "runtype": "./dist/index.js"
+  },
+  "dependencies": {
+    "@clerk/backend": "^2.28.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "conf": "^13.0.0",
+    "dotenv": "^16.4.5",
+    "express": "^4.19.2",
+    "inquirer": "^9.2.15",
+    "keytar": "^7.9.0",
+    "marked": "^12.0.0",
+    "marked-terminal": "^7.0.0",
+    "open": "^10.1.0",
+    "ora": "^8.0.1",
+    "uuid": "^9.0.1",
+    "@runtypelabs/sdk": "0.1.1",
+    "@travrse/shared": "1.0.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/inquirer": "^9.0.7",
+    "@types/node": "^20.11.24",
+    "@types/supertest": "^6.0.3",
+    "@types/uuid": "^9.0.8",
+    "@vitest/coverage-v8": "^3.2.4",
+    "supertest": "^7.1.4",
+    "tsup": "^8.0.2",
+    "tsx": "^4.7.1",
+    "typescript": "^5.3.3",
+    "vitest": "^1.3.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "runtype",
+    "cli",
+    "ai",
+    "automation",
+    "workflow"
+  ],
+  "author": "Runtype Labs",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/runtypelabs/core",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://runtype.com",
+  "bugs": {
+    "url": "https://github.com/runtypelabs/core/issues"
+  },
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsup",
+    "start": "node dist/index.js",
+    "type-check": "tsc --noEmit",
+    "test": "vitest",
+    "test:watch": "vitest watch",
+    "test:coverage": "vitest run --coverage",
+    "test:ui": "vitest --ui"
+  }
+}