@telara-cli/cli 0.1.0 → 0.1.2

package/README.md

@@ -1,25 +1,128 @@
-# @telera/cli
+# @telara-cli/cli
 
-Install the Telara CLI via npm.
+The official CLI for [Telara](https://telara.dev) — manage MCP configurations, API keys, and agent tool integrations from your terminal.
 
 ## Installation
 
+```bash
+npm install -g @telara-cli/cli
 ```
-npm install -g @telera/cli
-```
 
-## Usage
+### Alternative methods
+
+```bash
+# macOS / Linux
+curl -fsSL https://get.telara.dev/install.sh | sh
 
+# Windows (PowerShell)
+irm https://get.telara.dev/windows | iex
+
+# Homebrew
+brew install Telara-Labs/tap/telara
 ```
+
+## Quick start
+
+```bash
+# 1. Authenticate
 telara login
+
+# 2. Set up your agent tools (auto-detects installed tools)
 telara setup
-telara --help
+
+# 3. Verify everything is working
+telara doctor
 ```
 
-## Alternative installation
+## Commands
 
-```
-macOS/Linux: curl -fsSL https://get.telara.ai/install.sh | sh
-Windows:     irm https://get.telara.ai/windows | iex
-Homebrew:    brew install telera-ai/tap/telara
-```
+### Authentication
+
+| Command | Description |
+|---------|-------------|
+| `telara login` | Authenticate via browser (device flow) or `--token` |
+| `telara logout` | Revoke token and remove local credentials |
+| `telara whoami` | Show current user, org, and active context |
+
+### MCP configuration management
+
+| Command | Description |
+|---------|-------------|
+| `telara config list` | List accessible MCP configurations |
+| `telara config show <name>` | Show config details, data sources, and MCP URL |
+| `telara config keys <name>` | List API keys for a configuration |
+| `telara config generate-key <name>` | Generate a new API key (`--expires 30d\|90d\|1yr\|never`) |
+| `telara config revoke-key <id>` | Revoke an API key |
+| `telara config rotate-key <ctx>` | Rotate the key for a saved context |
+
+### Agent tool setup
+
+| Command | Description |
+|---------|-------------|
+| `telara setup` | Interactive setup — auto-detects installed tools |
+| `telara setup claude-code` | Configure Claude Code (`--managed` for enterprise) |
+| `telara setup cursor` | Configure Cursor |
+| `telara setup windsurf` | Configure Windsurf |
+| `telara setup vscode` | Configure VS Code (project scope) |
+| `telara setup all` | Configure all detected tools |
+| `telara init` | Write project-scoped MCP config for detected tools |
+
+### Contexts
+
+Contexts are named (config + API key) pairs for easy switching between environments.
+
+| Command | Description |
+|---------|-------------|
+| `telara context list` | List saved contexts |
+| `telara context create <name>` | Create a new context with a generated API key |
+| `telara context use <name>` | Switch active context |
+| `telara context current` | Show active context details and MCP URL |
+| `telara context delete <name>` | Delete a saved context |
+
+### Provisioning
+
+Generate MCP access keys for specific deployment scenarios.
+
+| Command | Description |
+|---------|-------------|
+| `telara provision claude-web` | Generate key for Claude.ai (Anthropic Organization Connector) |
+| `telara provision ci` | Generate key for CI/CD environments (GitHub Actions, GitLab CI) |
+| `telara provision managed` | Generate managed config for enterprise MDM/GPO deployment |
+
+### Diagnostics
+
+| Command | Description |
+|---------|-------------|
+| `telara doctor` | Check auth, connectivity, tool configs, contexts, and security |
+| `telara version` | Print version, commit, and build date |
+| `telara update` | Update CLI to the latest version |
+
+## Global flags
+
+| Flag | Description |
+|------|-------------|
+| `--api-url` | Override the Telara API base URL |
+| `--context` | Use a specific context for this command |
+| `-v, --verbose` | Print full HTTP responses on errors |
+
+## Supported agent tools
+
+- **Claude Code** (global or managed scope)
+- **Cursor** (global scope)
+- **Windsurf** (global scope)
+- **VS Code** (project scope)
+
+## Requirements
+
+- Node.js >= 14 (for npm installation)
+- macOS, Linux, or Windows
+- x86_64 or ARM64 architecture
+
+## Documentation
+
+- [Telara docs](https://telara.dev/docs)
+- [CLI installation guide](https://docs.telara.dev/mcp-clients/cli)
+
+## License
+
+MIT

package/bin/telara

@@ -3,9 +3,9 @@
 // If this script is still running, the postinstall step did not complete successfully.
 console.error('telara binary not found.');
 console.error('The postinstall step may have failed. Try reinstalling:');
-console.error('  npm install -g @telera/cli');
+console.error('  npm install -g @telara-cli/cli');
 console.error('');
 console.error('Or install manually:');
-console.error('  macOS/Linux: curl -fsSL https://get.telara.ai/install.sh | sh');
-console.error('  Windows:     irm https://get.telara.ai/windows | iex');
+console.error('  macOS/Linux: curl -fsSL https://get.telara.dev/install.sh | sh');
+console.error('  Windows:     irm https://get.telara.dev/windows | iex');
 process.exit(1);

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@telara-cli/cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Telara CLI — manage your MCP configurations",
-  "homepage": "https://telara.ai",
+  "homepage": "https://telara.dev",
   "repository": {
     "type": "git",
     "url": "https://github.com/Telara-Labs/Telara-CLI"

package/scripts/install.js

@@ -12,9 +12,9 @@ const { execSync } = require('child_process');
 const pkg = require('../package.json');
 const version = process.env.TELARA_VERSION || pkg.version;
 
-const PRIMARY_BASE_URL = 'https://get.telara.ai/download';
+const PRIMARY_BASE_URL = 'https://get.telara.dev/download';
 const FALLBACK_BASE_URL = 'https://github.com/Telara-Labs/Telara-CLI/releases/download';
-const MANUAL_INSTALL_URL = 'https://telara.ai/docs/cli/install';
+const MANUAL_INSTALL_URL = 'https://docs.telara.dev/mcp-clients/cli';
 
 function getPlatformInfo() {
   const platform = process.platform;
@@ -214,7 +214,7 @@ async function main() {
     console.log(`telara installed successfully.`);
     console.log('');
     console.log('Get started:');
-    console.log('  1. Generate a token at https://app.telara.ai/settings?tab=developer');
+    console.log('  1. Generate a token at https://app.telara.dev/settings?tab=developer');
     console.log('  2. telara login --token <your-token>');
     console.log('  3. telara setup claude-code');
   } finally {
@@ -232,8 +232,8 @@ main().catch((err) => {
   console.error('telara install failed: ' + err.message);
   console.error('');
   console.error('Install manually:');
-  console.error('  macOS/Linux: curl -fsSL https://get.telara.ai/install.sh | sh');
-  console.error('  Windows:     irm https://get.telara.ai/windows | iex');
+  console.error('  macOS/Linux: curl -fsSL https://get.telara.dev/install.sh | sh');
+  console.error('  Windows:     irm https://get.telara.dev/windows | iex');
   console.error('  More options: ' + MANUAL_INSTALL_URL);
   console.error('');
   process.exit(1);