{"_id":"@alsania-io/cli","name":"@alsania-io/cli","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"$schema":"https://json.schemastore.org/package.json","name":"@alsania-io/cli","version":"1.0.0","description":"Alsania CLI - Unified command-line interface for the entire Alsania ecosystem","keywords":["alsania","cli","mcp","tool-registry","gateway","monorepo","management"],"homepage":"https://github.com/alsania-io/alsania-cli#readme","bugs":{"url":"https://github.com/alsania-io/alsania-cli/issues"},"repository":{"type":"git","url":"git+https://github.com/alsania-io/alsania-cli.git"},"license":"MIT","author":{"name":"Alsania"},"type":"module","main":"dist/index.js","types":"./dist/index.d.ts","bin":{"alsania":"dist/cli.js","als":"dist/cli.js"},"directories":{"doc":"docs","test":"tests"},"scripts":{"dev":"tsx watch src/cli.ts","build":"tsc","start":"node dist/cli.js","test":"jest","test:watch":"jest --watch","lint":"eslint src/**/*.ts --ext .ts","lint:fix":"eslint src/**/*.ts --ext .ts --fix","format":"prettier --write \"src/**/*.ts\" \"*.{json,md}\"","format:check":"prettier --check \"src/**/*.ts\" \"*.{json,md}\"","type-check":"tsc --noEmit","clean":"rm -rf dist","prepublishOnly":"npm run build"},"dependencies":{"chalk":"^5.6.2","commander":"^14.0.2","cross-spawn":"^7.0.6","dotenv":"^17.2.3","nanoid":"^5.1.6","ora":"^9.0.0","tsx":"^4.20.6"},"devDependencies":{"@types/cross-spawn":"^6.0.6","@types/node":"^24.9.2","@typescript-eslint/eslint-plugin":"^8.46.2","@typescript-eslint/parser":"^8.46.2","eslint":"^9.39.0","eslint-config-prettier":"^10.1.8","eslint-plugin-prettier":"^5.5.4","jest":"^30.2.0","prettier":"^3.6.2","typescript":"^5.9.3"},"gitHead":"2aa3c2066e89736d6bec8dff1c44adc1c1051809","_id":"@alsania-io/cli@1.0.0","_nodeVersion":"22.19.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-RjFj/dmUoZ9pRmB6VjVgfUuLQo7TAcE+zvuI4oGNnXKVsMI5ypSYssN6y6tH80KUeTLSLAyJfiGwGuGJ+prxmw==","shasum":"a6d7f3a020c16d07b6ecea09b36ae6df089c64d5","tarball":"https://registry.npmjs.org/@alsania-io/cli/-/cli-1.0.0.tgz","fileCount":9,"unpackedSize":45553,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDw5xqS8OoCpWt5uRX0nK0ypQc52D7p5YhBYOryTptppgIhAJYVE9rcQgTgAYE8lDb9Y9bln13iRmVJk8yH8x+ystdR"}]},"_npmUser":{"name":"sigmasauer07","email":"sigma.sauer07@gmail.com"},"maintainers":[{"name":"sigmasauer07","email":"sigma.sauer07@gmail.com"},{"name":"echo-dev","email":"alsaniasoftware@gmail.com"},{"name":"sigmasauer-dev","email":"sigmasauer.dev@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cli_1.0.0_1762143994194_0.3949892255886138"},"_hasShrinkwrap":false}},"time":{"created":"2025-11-03T04:26:34.088Z","1.0.0":"2025-11-03T04:26:34.376Z","modified":"2025-11-03T04:26:34.735Z"},"maintainers":[{"name":"sigmasauer07","email":"sigma.sauer07@gmail.com"},{"name":"echo-dev","email":"alsaniasoftware@gmail.com"},{"name":"sigmasauer-dev","email":"sigmasauer.dev@gmail.com"}],"description":"Alsania CLI - Unified command-line interface for the entire Alsania ecosystem","homepage":"https://github.com/alsania-io/alsania-cli#readme","keywords":["alsania","cli","mcp","tool-registry","gateway","monorepo","management"],"repository":{"type":"git","url":"git+https://github.com/alsania-io/alsania-cli.git"},"author":{"name":"Alsania"},"bugs":{"url":"https://github.com/alsania-io/alsania-cli/issues"},"license":"MIT","readme":"# @alsania-io/cli\n\n> Unified command-line interface for the entire Alsania ecosystem\n\n## Overview\n\nThe Alsania CLI (`alsania` or `als`) is a unified command-line tool for managing the Echo System (AI Layer) and future Alsania services. It provides a consistent interface for starting, stopping, and managing:\n\n- **AlsaniaMCP** (`mcp`) - Universal MCP proxy server (Port 8050)\n- **Tool Registry** (`registry`) - Dynamic tool registry (Port 8070)\n- **Alsania Gateway** (`gateway`) - FastAPI gateway (Port 8052)\n- **Snapshot Manager** (`snapshot`) - Backup management (Port 8060)\n\n## Installation\n\n### From the monorepo\n\n```bash\ncd services/alsania-cli\nnpm install\nnpm run build\nnpm link\n```\n\n### From npm (when published)\n\n```bash\nnpm install -g @alsania-io/cli\n```\n\n## Usage\n\n### Echo System (AI Layer) Management\n\n```bash\n# List all available Echo-Sys services\nalsania esys list\nalsania echosys ls\n\n# Start a specific service\nalsania esys start mcp\nalsania esys start registry\nalsania esys start gateway\nalsania esys start snapshot\n\n# Start service in background\nalsania esys start mcp --detached\nalsania esys start mcp -d\n\n# Start service on custom port\nalsania esys start mcp --port 9000\n\n# Stop a service\nalsania esys stop mcp\n\n# Check service status\nalsania esys status\nalsania esys status mcp\n\n# Restart a service\nalsania esys restart mcp\n\n# Start all Echo-Sys services at once\nalsania start-all\n```\n\n### MCP Commands\n\nThe CLI can delegate to AlsaniaMCP commands:\n\n```bash\n# Run any AlsaniaMCP command\nalsania mcp server start\nalsania mcp server stop\nalsania mcp server status\nalsania mcp voice check\nalsania mcp comm peers\nalsania mcp tools list\nalsania mcp config init\n```\n\n## Service Ports\n\n| Service | Port | Description |\n|---------|------|-------------|\n| AlsaniaMCP | 8050 | Universal MCP proxy server |\n| Tool Registry | 8070 | Dynamic tool registry |\n| Alsania Gateway | 8052 | FastAPI gateway |\n| Snapshot Manager | 8060 | Backup management |\n\n## Commands Reference\n\n### `alsania esys list`\nLists all available Echo-Sys services with their descriptions and ports.\n\n### `alsania esys start <service>`\nStarts the specified Echo-Sys service.\n\n**Options:**\n- `-d, --detached` - Run service in background\n- `-p, --port <port>` - Override default port\n\n**Services:**\n- `mcp` - AlsaniaMCP\n- `registry` - Tool Registry\n- `gateway` - Alsania Gateway\n- `snapshot` - Snapshot Manager\n\n### `alsania esys stop <service>`\nStops the specified Echo-Sys service.\n\n**Options:**\n- `-f, --force` - Force kill the service\n\n### `alsania esys status [service]`\nCheck the status of all Echo-Sys services or a specific service.\n\n### `alsania esys restart <service>`\nRestart a specific Echo-Sys service (stops then starts).\n\n### `alsania start-all`\nStart all Echo-Sys services in the background.\n\n### `alsania mcp <command> [args...]`\nDelegate to AlsaniaMCP CLI commands. See [@alsania-io/mcp](../alsaniamcp/README.md) for available commands.\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Build the CLI\nnpm run build\n\n# Run in development mode\nnpm run dev\n\n# Run linting\nnpm run lint\nnpm run lint:fix\n\n# Format code\nnpm run format\nnpm run format:check\n\n# Type checking\nnpm run type-check\n```\n\n## Architecture\n\nThe Alsania CLI is designed to:\n\n1. **Centralize service management** - Single entry point for all Alsania services\n2. **Maintain separation** - Each service remains independent and can be run standalone\n3. **Provide consistency** - Unified command structure across all services\n4. **Enable delegation** - Can delegate to service-specific CLIs when needed\n\n## Best Practices\n\n### Naming Convention\n\nAll Alsania packages follow the `@alsania-io/*` naming convention:\n\n- `@alsania-io/cli` - This CLI tool\n- `@alsania-io/mcp` - AlsaniaMCP server\n- `@alsania-io/tool-registry` - Tool Registry server\n- `@alsania-io/gateway` - Alsania Gateway\n\n### Service Management\n\n- Use `alsania esys start <service>` for development (foreground)\n- Use `alsania esys start <service> -d` for production (background)\n- Use `alsania start-all` to quickly start the entire Echo-Sys\n- Check `alsania esys status` regularly to monitor services\n\n### Integration with AlsaniaMCP\n\nThe CLI delegates MCP-specific commands to the AlsaniaMCP package, maintaining a clean separation of concerns while providing a unified interface.\n\n## License\n\nMIT © Alsania\n\n## Contributing\n\nThis is part of the Alsania monorepo. See the main repository for contribution guidelines.\n\n## Links\n\n- [AlsaniaMCP](../alsaniamcp/README.md)\n- [Tool Registry](../.registry/server/README.md)\n- [Alsania Gateway](../alsania-gateway/README.md)\n\n","readmeFilename":"README.md","_rev":"1-57451a7392b4e8b73f56414c340e61ec"}