@elizaos/cli 1.0.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Shaw Walters, aka Moon aka @lalalune
+
+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,188 @@
+# TEE CLI
+
+The TEE CLI provides a set of commands to manage your ElizaOS TEE deployments, from local development to cloud deployment.
+
+## Getting Started
+
+### Prerequisites
+
+- Docker installed and running
+- Node.js and npm/bun installed
+- A Docker Hub account for publishing images
+- A Phala Cloud (https://cloud.phala.network/login) API key for cloud deployments
+
+## Commands
+
+### Building Your Image
+
+Build your Docker image locally:
+
+```bash
+elizaos tee phala build \
+  -i your-image-name \
+  -u your-dockerhub-username \
+  -f path/to/Dockerfile \
+  -t tag-name
+```
+
+### Running the TEE Simulator
+
+Start the local TEE simulator for testing:
+
+```bash
+elizaos tee phala simulator
+```
+This will start the simulator on http://localhost:8090.
+
+### Local Development
+
+You can develop your agent locally in two ways:
+
+1. Build the docker-compose file separately:
+```bash
+elizaos tee phala build-compose \
+  -i your-image-name \
+  -u your-dockerhub-username \
+  -t tag-name \
+  -c path/to/character.json \
+  -e path/to/.env \
+  -v v2  # or v1 for legacy mode
+```
+
+2. Run an existing compose file:
+```bash
+elizaos tee phala run-local \
+  -c path/to/docker-compose.yml \
+  -e path/to/.env
+```
+
+This separation allows you to:
+- Build compose files without running them immediately
+- Version control your compose files
+- Share compose files with team members
+- Run the same compose file multiple times
+
+The CLI will store generated compose files in:
+```
+.tee-cloud/
+  └── compose-files/     # Generated docker-compose files
+      └── your-character-tee-compose.yaml
+```
+
+### Publishing Your Image
+
+Push your built image to Docker Hub:
+
+```bash
+elizaos tee phala publish \
+  -i your-image-name \
+  -u your-dockerhub-username \
+  -t tag-name
+```
+
+### List Available Tags
+
+View all tags for your image on Docker Hub:
+
+```bash
+elizaos tee phala list-tags \
+  -i your-image-name \
+  -u your-dockerhub-username
+```
+
+### Cloud Deployment
+
+First, set your Phala Cloud API key:
+
+```bash
+elizaos tee phala set-apikey your-api-key
+```
+
+Deploy to Phala Cloud:
+
+```bash
+elizaos tee phala deploy \
+  -t phala \
+  -m docker-compose \
+  -n your-deployment-name \
+  -c path/to/docker-compose.yml \
+  --env-file path/to/.env
+```
+
+### Managing Cloud Deployments
+
+List your active agents (CVMs):
+
+```bash
+elizaos tee phala list-cvms
+```
+
+List your TEE pods:
+```bash
+elizaos tee phala teepods
+```
+
+List images in a specific TEE pod:
+```bash
+elizaos tee phala images --teepod-id your-teepod-id
+```
+
+Upgrade an existing deployment:
+```bash
+elizaos tee phala upgrade \
+  -t phala \
+  -m docker-compose \
+  --app-id your-app-id \
+  -c path/to/docker-compose.yml \
+  --env-file path/to/.env
+```
+
+## Directory Structure
+
+The CLI will create the following directory structure:
+```
+.tee-cloud/
+  └── compose-files/     # Generated docker-compose files
+```
+
+## Environment Variables
+
+Create a .env file with your required variables:
+
+```env
+ANTHROPIC_API_KEY=your_key
+TELEGRAM_BOT_TOKEN=your_token
+# Add other required variables
+```
+
+## Tips
+
+- Use the simulator for local testing before cloud deployment
+- Always test your image locally with `run-local` before publishing
+- Keep your API keys secure and never commit them to version control
+- Use the `--help` flag with any command for detailed usage information
+
+## Troubleshooting
+
+Common issues and solutions:
+
+1. **Docker Build Fails**
+   - Ensure Docker daemon is running
+   - Check Dockerfile path is correct
+   - Verify you have necessary permissions
+
+2. **Simulator Connection Issues**
+   - Check if port 8090 is available
+   - Ensure Docker has necessary permissions
+
+3. **Cloud Deployment Fails**
+   - Verify API key is set correctly
+   - Check if image exists on Docker Hub
+   - Ensure environment variables are properly set
+
+For more help, use the `--help` flag with any command:
+
+```bash
+elizaos tee phala --help
+elizaos tee phala <command> --help
+```

package/dist/index.d.ts

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