@castari/cli 0.0.10 → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Castari
+
+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,20 +1,125 @@
 # @castari/cli
 
-The Command Line Interface for Castari.
+The command line interface for building and deploying Castari agents.
 
 ## Installation
 
 ```bash
 npm install -g @castari/cli
+# or
+bun add -g @castari/cli
 ```
 
-## Usage
+## Quick Start
 
-See the [CLI Reference](../../docs/cli-reference.md) for detailed documentation.
+```bash
+# Create a new agent project
+castari init
+
+# Run locally for development
+castari dev
+
+# Deploy to Castari Platform
+castari deploy
+
+# Start a cloud sandbox
+castari start
+```
+
+## Commands
+
+### `castari init`
+
+Scaffolds a new Castari agent project.
+
+```bash
+castari init          # Basic agent scaffold
+castari init --demo   # Full demo with agent + Next.js chat UI
+```
+
+Creates:
+- `package.json` - Configured with dependencies
+- `tsconfig.json` - TypeScript configuration
+- `src/agent.ts` - Starter agent code
+- `.env.example` - Environment variable template
+
+### `castari dev`
+
+Runs the agent locally for development.
+
+```bash
+castari dev
+```
+
+Starts a local server at `http://localhost:3000` with hot reloading.
+
+### `castari deploy`
+
+Uploads your agent to the Castari Platform.
 
 ```bash
-castari init      # Create a new agent
-castari dev       # Run locally
-castari deploy    # Deploy to Platform
-castari start     # Start sandbox
+castari deploy
+castari deploy --name my-custom-name
 ```
+
+**Options:**
+- `--name <name>` - Override the snapshot name (defaults to package.json name)
+
+**Requires:** `CASTARI_CLIENT_ID` environment variable
+
+### `castari start`
+
+Starts a cloud sandbox and connects to your agent.
+
+```bash
+castari start
+castari start --snapshot my-agent --volume my-data
+```
+
+**Options:**
+- `--snapshot <name>` - Snapshot to use (defaults to package.json name)
+- `--volume <name>` - Volume to mount for persistent storage
+
+**Requires:** `CASTARI_CLIENT_ID` and `ANTHROPIC_API_KEY` environment variables
+
+Press `Ctrl+C` to gracefully shut down.
+
+### `castari generate-client-id`
+
+Creates a new Castari client ID and stores it in `~/.castari/client.json`.
+
+```bash
+castari generate-client-id
+```
+
+## Configuration
+
+### Environment Variables
+
+Create a `.env` file in your project:
+
+```env
+ANTHROPIC_API_KEY=sk-ant-...
+CASTARI_CLIENT_ID=your-client-id
+# CASTARI_PLATFORM_URL=https://castari-api-12511-04c55b73-g4p2s9om.onporter.run
+```
+
+### package.json
+
+```json
+{
+  "name": "my-agent",
+  "castari": {
+    "volume": "my-volume-name"
+  }
+}
+```
+
+## Prerequisites
+
+- [Bun](https://bun.sh) v1.0+
+- [Anthropic](https://anthropic.com) API key
+
+## License
+
+MIT

package/dist/commands/deploy.js

@@ -41,7 +41,7 @@ export async function deploy(options) {
     });
     const zipBuffer = zip.toBuffer();
     console.log(chalk.blue(`🚀 Uploading to Castari Platform...`));
-    const platformUrl = process.env.CASTARI_PLATFORM_URL || 'http://localhost:3000';
+    const platformUrl = process.env.CASTARI_PLATFORM_URL || 'https://castari-api-12511-04c55b73-g4p2s9om.onporter.run';
     const formData = new FormData();
     formData.append('file', new Blob([zipBuffer]), 'source.zip');
     formData.append('snapshot', snapshotName);

package/dist/commands/generate-client-id.js

@@ -3,7 +3,7 @@ import inquirer from 'inquirer';
 import chalk from 'chalk';
 import { saveClientAuth } from '../utils/client-auth';
 export async function generateClientId() {
-    const platformUrl = process.env.CASTARI_PLATFORM_URL || 'http://localhost:3000';
+    const platformUrl = process.env.CASTARI_PLATFORM_URL || 'https://castari-api-12511-04c55b73-g4p2s9om.onporter.run';
     const mintOnline = async () => {
         try {
             const res = await fetch(`${platformUrl}/client-ids`, { method: 'POST' });

package/dist/commands/init.js

@@ -64,7 +64,7 @@ serve({
   systemPrompt: 'You are a helpful Castari agent.',
 })
 `;
-    const envExample = `ANTHROPIC_API_KEY=sk-ant-...\nCASTARI_CLIENT_ID=your-client-id\nCASTARI_API_KEY=castari_your-api-key\n# CASTARI_PLATFORM_URL=https://api.castari.com\n`;
+    const envExample = `ANTHROPIC_API_KEY=sk-ant-...\nCASTARI_CLIENT_ID=your-client-id\nCASTARI_API_KEY=castari_your-api-key\n# CASTARI_PLATFORM_URL=https://castari-api-12511-04c55b73-g4p2s9om.onporter.run\n`;
     await writeFile('package.json', JSON.stringify(packageJson, null, 2));
     await writeFile('tsconfig.json', JSON.stringify(tsConfig, null, 2));
     await writeFile('.env.example', envExample);
@@ -110,7 +110,7 @@ async function initDemo() {
         },
         include: ['src'],
     });
-    await writeFile(join(agentDir, '.env.example'), 'ANTHROPIC_API_KEY=sk-ant-...\nCASTARI_CLIENT_ID=your-client-id\nCASTARI_API_KEY=castari_your-api-key\n# CASTARI_PLATFORM_URL=http://localhost:3000\n');
+    await writeFile(join(agentDir, '.env.example'), 'ANTHROPIC_API_KEY=sk-ant-...\nCASTARI_CLIENT_ID=your-client-id\nCASTARI_API_KEY=castari_your-api-key\n# CASTARI_PLATFORM_URL=https://castari-api-12511-04c55b73-g4p2s9om.onporter.run\n');
     await writeFile(join(agentDir, 'src', 'agent.ts'), `import { serve } from '@castari/sdk'
 
 serve({
@@ -187,7 +187,7 @@ const nextConfig = {
 
 export default nextConfig
 `);
-    await writeFile(join(webDir, '.env.example'), 'ANTHROPIC_API_KEY=sk-ant-...\nCASTARI_CLIENT_ID=your-client-id\nCASTARI_API_KEY=castari_your-api-key\n# CASTARI_PLATFORM_URL=http://localhost:3000\n# CASTARI_DEBUG=false\n');
+    await writeFile(join(webDir, '.env.example'), 'ANTHROPIC_API_KEY=sk-ant-...\nCASTARI_CLIENT_ID=your-client-id\nCASTARI_API_KEY=castari_your-api-key\n# CASTARI_PLATFORM_URL=https://castari-api-12511-04c55b73-g4p2s9om.onporter.run\n# CASTARI_DEBUG=false\n');
     await writeFile(join(webDir, 'app', 'globals.css'), `:root {
   color-scheme: dark;
   --bg: #131418;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@castari/cli",
-    "version": "0.0.10",
+    "version": "0.1.1",
     "type": "module",
     "bin": {
         "castari": "./dist/index.js"
@@ -8,7 +8,7 @@
     "files": [
         "dist"
     ],
-    "license": "UNLICENSED",
+    "license": "MIT",
     "publishConfig": {
         "access": "public"
     },
@@ -18,7 +18,7 @@
     },
     "dependencies": {
         "@anthropic-ai/claude-agent-sdk": "^0.1.44",
-        "@castari/sdk": "^0.0.7",
+        "@castari/sdk": "^0.1.1",
         "adm-zip": "^0.5.16",
         "cac": "^6.7.14",
         "chalk": "^5.3.0",
@@ -28,6 +28,7 @@
     },
     "devDependencies": {
         "@types/adm-zip": "^0.5.7",
+        "@types/bun": "^1.3.3",
         "@types/form-data": "^2.5.2",
         "@types/inquirer": "^9.0.7",
         "@types/node": "^20.10.0",