@edgible-team/cli 1.0.1

package/LICENSE

@@ -0,0 +1,136 @@
+PolyForm Noncommercial License 1.0.0
+
+<https://polyformproject.org/licenses/noncommercial/1.0.0>
+
+Copyright (c) 2025 Edgible Team. All Rights Reserved.
+
+Required Notice: Copyright (c) 2025 Edgible Team. All Rights Reserved.
+
+## Acceptance
+
+In order to get any license under these terms, you must agree
+to them as both strict obligations and conditions to all
+your licenses.
+
+## Copyright License
+
+The licensor grants you a copyright license for the
+software to do everything you might do with the software
+that would otherwise infringe the licensor's copyright
+in it for any permitted purpose.  However, you may
+only distribute the software according to Distribution
+License and make changes or new works
+based on the software according to Changes and New Works
+License.
+
+## Distribution License
+
+The licensor grants you an additional copyright license
+to distribute copies of the software.  Your license
+to distribute covers distributing the software with
+changes and new works permitted by Changes and New Works
+License.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of
+the software from you also gets a copy of these terms or the
+URL for them above, as well as copies of any plain-text lines
+beginning with `Required Notice:` that the licensor provided
+with the software.  For example:
+
+> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+## Changes and New Works License
+
+The licensor grants you an additional copyright license to
+make changes and new works based on the software for any
+permitted purpose.
+
+## Patent License
+
+The licensor grants you a patent license for the software that
+covers patent claims the licensor can license, or becomes able
+to license, that you would infringe by using the software.
+
+## Noncommercial Purposes
+
+Any noncommercial purpose is a permitted purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for
+the benefit of public knowledge, personal study, private
+entertainment, hobby projects, amateur pursuits, or religious
+observance, without any anticipated commercial application,
+is use for a permitted purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution,
+public research organization, public safety or health
+organization, environmental protection organization,
+or government institution is use for a permitted purpose
+regardless of the source of funding or obligations resulting
+from the funding.
+
+## Fair Use
+
+You may have "fair use" rights for the software under the
+law. These terms do not limit them.
+
+## No Other Rights
+
+These terms do not allow you to sublicense or transfer any of
+your licenses to anyone else, or prevent the licensor from
+granting licenses to anyone else.  These terms do not imply
+any other licenses.
+
+## Patent Defense
+
+If you make any written claim that the software infringes or
+contributes to infringement of any patent, your patent license
+for the software granted under these terms ends immediately. If
+your company makes such a claim, your patent license ends
+immediately for work on behalf of your company.
+
+## Violations
+
+The first time you are notified in writing that you have
+violated any of these terms, or done anything with the software
+not covered by your licenses, your licenses can nonetheless
+continue if you come into full compliance with these terms,
+and take practical steps to correct past violations, within
+32 days of receiving notice.  Otherwise, all your licenses
+end immediately.
+
+## No Liability
+
+***As far as the law allows, the software comes as is, without
+any warranty or condition, and the licensor will not be liable
+to you for any damages arising out of these terms or the use
+or nature of the software, under any kind of legal claim.***
+
+## Definitions
+
+The **licensor** is the individual or entity offering these
+terms, and the **software** is the software the licensor makes
+available under these terms.
+
+**You** refers to the individual or entity agreeing to these
+terms.
+
+**Your company** is any legal entity, sole proprietorship,
+or other kind of organization that you work for, plus all
+organizations that have control over, are under the control of,
+or are under common control with that organization.  **Control**
+means ownership of substantially all the assets of an entity,
+or the power to direct its management and policies by vote,
+contract, or otherwise.  Control can be direct or indirect.
+
+**Your licenses** are all the licenses granted to you for the
+software under these terms.
+
+**Use** means anything you do with the software requiring one
+of your licenses.
+

package/README.md

@@ -0,0 +1,450 @@
+# Edgible CLI
+
+A command-line tool for managing your Edgible private network, applications, and gateways.
+
+## Quick Start
+
+### Installation
+
+```bash
+npm install -g @edgible-team/cli
+```
+
+After installation, you'll see a welcome message with quick start instructions.
+
+### First Steps
+
+1. **Login to your account:**
+   ```bash
+   edgible auth login
+   ```
+
+2. **Check your configuration:**
+   ```bash
+   edgible config list
+   ```
+
+3. **Get help:**
+   ```bash
+   edgible --help
+   ```
+
+That's it! The CLI is ready to use. No configuration files or environment variables needed.
+
+## Getting Started
+
+### Login Options
+
+When you run `edgible auth login` for the first time, you'll see:
+
+- **User Login**: Sign in with your existing Edgible account email and password
+- **Device Login**: Create a device without an account (an invite email will be sent)
+
+The CLI automatically detects your infrastructure tools (Docker, Kubernetes, etc.) and saves your preferences for future use.
+
+### Check Your Setup
+
+```bash
+# View your configuration
+edgible config list
+
+# Discover available tools on your system
+edgible discover tools
+
+# List running workloads (Docker containers, processes, etc.)
+edgible discover workloads
+```
+
+## Common Commands
+
+### Authentication
+
+```bash
+# Login to your account
+edgible auth login
+
+# Logout
+edgible auth logout
+
+# Select active organization
+edgible auth select-org
+```
+
+### Applications
+
+```bash
+# List all your applications
+edgible application list
+# or use alias
+edgible app ls
+
+# Create an application for an existing service
+edgible application create existing --name myapp --port 3000
+
+# Create an application interactively
+edgible application create existing
+
+# Get application status/details
+edgible application get --app-id <id>
+# or use alias
+edgible app status --app-id <id>
+
+# Update an application
+edgible application update --app-id <id>
+
+# Delete an application
+edgible application delete --app-id <id>
+# or use alias
+edgible app rm --app-id <id>
+```
+
+### Gateways
+
+Gateways provide internet access for your applications.
+
+```bash
+# List all gateways
+edgible gateway list
+# or use alias
+edgible gw ls
+
+# Create a new gateway
+edgible gateway create --name mygateway
+
+# Get gateway status
+edgible gateway get --id <gateway-id>
+# or use alias
+edgible gw status --id <gateway-id>
+
+# Update a gateway
+edgible gateway update --id <gateway-id>
+
+# Delete a gateway
+edgible gateway delete --id <gateway-id>
+# or use alias
+edgible gw rm --id <gateway-id>
+
+# View gateway logs
+edgible gateway logs --id <gateway-id>
+
+# Follow gateway logs in real-time
+edgible gateway logs --id <gateway-id> --follow
+
+# Connect to gateway via SSH
+edgible gateway ssh --id <gateway-id>
+
+# Resync gateway agent
+edgible gateway resync --id <gateway-id>
+
+# Clear gateway logs
+edgible gateway wipe-logs --id <gateway-id>
+```
+
+### Agent Management
+
+The agent runs on your serving devices to manage connectivity.
+
+```bash
+# Check agent status
+edgible agent status
+
+# Setup agent dependencies and configure
+edgible agent setup
+
+# Install the agent
+edgible agent install
+
+# Start the agent
+edgible agent start
+
+# Stop the agent
+edgible agent stop
+
+# Restart the agent
+edgible agent restart
+
+# View agent logs
+edgible agent logs
+
+# Follow agent logs
+edgible agent logs --follow
+
+# Set agent log level
+edgible agent set-log-level <level>
+
+# Uninstall the agent
+edgible agent uninstall
+```
+
+### Discovery & Tools
+
+```bash
+# Discover available infrastructure tools
+edgible discover tools
+
+# Discover running workloads
+edgible discover workloads
+
+# Check system capabilities (CPU, RAM, GPU)
+edgible discover capabilities
+# or use alias
+edgible discover caps
+```
+
+### Configuration
+
+```bash
+# List all configuration values
+edgible config list
+# or use alias
+edgible config ls
+
+# Get a specific configuration value
+edgible config get <key>
+
+# Set a configuration value
+edgible config set <key> <value>
+
+# Reset CLI configuration
+edgible config reset
+```
+
+### Connectivity Testing
+
+```bash
+# Test connectivity for an application
+edgible connectivity test --app-id <id>
+```
+
+### AI Service Management
+
+```bash
+# Setup Ollama AI service
+edgible ai setup
+
+# Stop Ollama service
+edgible ai stop
+```
+
+## Command Reference
+
+### Authentication Commands
+
+| Command | Description |
+|---------|-------------|
+| `edgible auth login` | Login with user account or create device login |
+| `edgible auth logout` | Log out of the Edgible service |
+| `edgible auth select-org` | Select active organization |
+
+### Application Commands
+
+| Command | Description |
+|---------|-------------|
+| `edgible application list` or `edgible app ls` | List all applications |
+| `edgible application create existing` | Create app for existing service |
+| `edgible application get --app-id <id>` or `edgible app status --app-id <id>` | Get application status/details |
+| `edgible application update --app-id <id>` | Update an existing application |
+| `edgible application delete --app-id <id>` or `edgible app rm --app-id <id>` | Delete an application |
+
+### Gateway Commands
+
+| Command | Description |
+|---------|-------------|
+| `edgible gateway list` or `edgible gw ls` | List all gateways |
+| `edgible gateway create` | Create a new gateway |
+| `edgible gateway get --id <id>` or `edgible gw status --id <id>` | Get gateway status |
+| `edgible gateway update --id <id>` | Update a gateway |
+| `edgible gateway delete --id <id>` or `edgible gw rm --id <id>` | Delete a gateway |
+| `edgible gateway logs --id <id>` | View gateway logs |
+| `edgible gateway resync --id <id>` | Resync gateway agent |
+| `edgible gateway ssh --id <id>` | Connect to gateway via SSH |
+| `edgible gateway wipe-logs --id <id>` | Clear gateway logs |
+
+### Agent Commands
+
+| Command | Description |
+|---------|-------------|
+| `edgible agent status` | Check agent status |
+| `edgible agent setup` | Setup agent dependencies and configure |
+| `edgible agent install` | Install the agent |
+| `edgible agent start` | Start the agent |
+| `edgible agent stop` | Stop the agent |
+| `edgible agent restart` | Restart the agent |
+| `edgible agent logs` | View agent logs |
+| `edgible agent set-log-level <level>` | Set agent log level |
+| `edgible agent uninstall` | Uninstall the agent |
+
+### Discovery Commands
+
+| Command | Description |
+|---------|-------------|
+| `edgible discover tools` | Detect available tools |
+| `edgible discover workloads` | Find running workloads |
+| `edgible discover capabilities` or `edgible discover caps` | Check system capabilities |
+
+### Configuration Commands
+
+| Command | Description |
+|---------|-------------|
+| `edgible config list` or `edgible config ls` | List all configuration values |
+| `edgible config get <key>` | Get a configuration value |
+| `edgible config set <key> <value>` | Set a configuration value |
+| `edgible config reset` | Reset CLI configuration |
+
+### Connectivity Commands
+
+| Command | Description |
+|---------|-------------|
+| `edgible connectivity test --app-id <id>` | Test connectivity for an application |
+
+### AI Commands
+
+| Command | Description |
+|---------|-------------|
+| `edgible ai setup` | Setup Ollama AI service |
+| `edgible ai stop` | Stop Ollama service |
+
+## Examples
+
+### Create and Deploy an Application
+
+```bash
+# 1. Login to your account
+edgible auth login
+
+# 2. Discover what's running on your system
+edgible discover workloads
+
+# 3. Create an application for a service on port 3000
+edgible application create existing --name myapp --port 3000
+
+# 4. Check application status
+edgible application get --app-id <app-id>
+```
+
+### Set Up Internet Access
+
+```bash
+# 1. Create a gateway (requires AWS credentials)
+edgible gateway create --name mygateway --region us-east-1
+
+# 2. List your gateways
+edgible gateway list
+
+# 3. Create an application with gateway access
+edgible application create existing --name myapp --port 3000 --gateway-ids <gateway-id>
+```
+
+### Manage Your Agent
+
+```bash
+# Install and start the agent
+edgible agent install
+edgible agent start
+
+# Check if it's running
+edgible agent status
+
+# View logs
+edgible agent logs --follow
+```
+
+## Output Options
+
+The CLI supports several output options:
+
+```bash
+# Disable colored output
+edgible --no-color status
+
+# Plain text output (no colors, no emojis)
+edgible --plain status
+
+# JSON output (for some commands)
+edgible application list --json
+```
+
+## Getting Help
+
+```bash
+# General help
+edgible --help
+
+# Command-specific help
+edgible auth --help
+edgible application --help
+edgible gateway --help
+edgible agent --help
+edgible config --help
+edgible discover --help
+
+# Version information
+edgible --version
+```
+
+## Requirements
+
+- **Node.js**: Version 16.0.0 or higher
+- **npm**: For installation
+
+## Troubleshooting
+
+### Agent Not Starting
+
+```bash
+# Check agent status
+edgible agent status
+
+# View agent logs
+edgible agent logs
+
+# Reinstall the agent
+edgible agent install
+```
+
+### Application Not Accessible
+
+```bash
+# Check application status
+edgible application get --app-id <id>
+
+# Test connectivity
+edgible connectivity test --app-id <id>
+
+# Verify the service is running on the specified port
+edgible discover workloads
+```
+
+### Gateway Issues
+
+```bash
+# Check gateway status
+edgible gateway list
+
+# View gateway logs
+edgible gateway logs --id <gateway-id> --follow
+
+# Resync the gateway
+edgible gateway resync --id <gateway-id>
+```
+
+## Advanced Configuration
+
+The CLI works out of the box with sensible defaults. Advanced users can configure behavior using environment variables:
+
+- `STAGE` or `SST_STAGE`: Environment stage (`dev`, `staging`, `prod`). Default: `prod`
+- `LOG_LEVEL`: Log verbosity (`DEBUG`, `INFO`, `WARN`, `ERROR`). Default: `INFO`
+- `NO_COLOR`: Disable colored output (set to `1` or `true`)
+- `PLAIN_OUTPUT`: Plain text output (set to `1` or `true`)
+
+**Note**: Most users don't need to set these. The CLI works with production defaults.
+
+## License
+
+PolyForm Noncommercial License 1.0.0 - see LICENSE file for details.
+
+This software is licensed under the PolyForm Noncommercial License 1.0.0, which allows free use for personal and non-commercial purposes. Commercial use is prohibited. For commercial licensing, please contact the copyright holder.
+
+## Support
+
+For issues, questions, or feature requests, please contact the Edgible team.