@telara-cli/cli 0.1.12 → 0.1.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +56 -45
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,6 +1,13 @@
1
+ <img alt="Telara" src="https://raw.githubusercontent.com/Telera-Labs/Telara-CLI/main/docs/logo-light.png" height="52">
2
+
1
3
  # @telara-cli/cli
2
4
 
3
- The official CLI for [Telara](https://telara.dev) — manage MCP configurations, API keys, and agent tool integrations from your terminal.
5
+ The official CLI for [Telara](https://telara.dev) — connect your AI coding tools to your organization's MCP configurations. Manage access, generate keys, and configure Claude Code, Cursor, Windsurf, and VS Code from your terminal.
6
+
7
+ [![npm](https://img.shields.io/npm/v/@telara-cli/cli?color=7c3aed)](https://www.npmjs.com/package/@telara-cli/cli)
8
+ [![License: MIT](https://img.shields.io/badge/License-MIT-7c3aed.svg)](https://github.com/Telara-Labs/Telara-CLI/blob/main/LICENSE)
9
+
10
+ ---
4
11
 
5
12
  ## Installation
6
13
 
@@ -8,39 +15,43 @@ The official CLI for [Telara](https://telara.dev) — manage MCP configurations,
8
15
  npm install -g @telara-cli/cli
9
16
  ```
10
17
 
11
- ### Alternative methods
18
+ **Other methods:**
12
19
 
13
20
  ```bash
21
+ # Homebrew
22
+ brew install Telara-Labs/tap/telara
23
+
14
24
  # macOS / Linux
15
25
  curl -fsSL https://get.telara.dev/install.sh | sh
16
26
 
17
27
  # Windows (PowerShell)
18
28
  irm https://get.telara.dev/windows | iex
19
-
20
- # Homebrew
21
- brew install Telara-Labs/tap/telara
22
29
  ```
23
30
 
31
+ ---
32
+
24
33
  ## Quick start
25
34
 
26
35
  ```bash
27
- # 1. Authenticate
36
+ # Log in (browser-based device flow)
28
37
  telara login
29
38
 
30
- # 2. Set up your agent tools (auto-detects installed tools)
39
+ # Set up your agent tools
31
40
  telara setup
32
41
 
33
- # 3. Verify everything is working
42
+ # Verify everything is working
34
43
  telara doctor
35
44
  ```
36
45
 
46
+ ---
47
+
37
48
  ## Commands
38
49
 
39
50
  ### Authentication
40
51
 
41
52
  | Command | Description |
42
53
  |---------|-------------|
43
- | `telara login` | Authenticate via browser (device flow) or `--token` |
54
+ | `telara login` | Authenticate via browser (device flow) or `--token <tlrc_...>` |
44
55
  | `telara logout` | Revoke token and remove local credentials |
45
56
  | `telara whoami` | Show current user, org, and active context |
46
57
 
@@ -48,81 +59,81 @@ telara doctor
48
59
 
49
60
  | Command | Description |
50
61
  |---------|-------------|
51
- | `telara config list` | List accessible MCP configurations |
52
- | `telara config show <name>` | Show config details, data sources, and MCP URL |
53
- | `telara config keys <name>` | List API keys for a configuration |
62
+ | `telara config list` | List MCP configurations accessible to you |
63
+ | `telara config show <name>` | Show data sources, policies, key count, and MCP URL |
64
+ | `telara config keys <name>` | List active API keys with scope and expiry |
54
65
  | `telara config generate-key <name>` | Generate a new API key (`--expires 30d\|90d\|1yr\|never`) |
55
- | `telara config revoke-key <id>` | Revoke an API key |
56
- | `telara config rotate-key <ctx>` | Rotate the key for a saved context |
66
+ | `telara config revoke-key <key-id> --config <id>` | Revoke an API key immediately |
67
+ | `telara config rotate-key <context-name>` | Generate a replacement key and auto-revoke the old one |
57
68
 
58
69
  ### Agent tool setup
59
70
 
60
71
  | Command | Description |
61
72
  |---------|-------------|
62
- | `telara setup` | Interactive setup — auto-detects installed tools |
63
- | `telara setup claude-code` | Configure Claude Code (`--managed` for enterprise) |
73
+ | `telara setup` | Interactive setup — auto-detects all installed tools |
74
+ | `telara setup claude-code` | Configure Claude Code (`--managed` for enterprise MDM) |
64
75
  | `telara setup cursor` | Configure Cursor |
65
76
  | `telara setup windsurf` | Configure Windsurf |
66
- | `telara setup vscode` | Configure VS Code (project scope) |
67
- | `telara setup all` | Configure all detected tools |
68
- | `telara init` | Write project-scoped MCP config for detected tools |
77
+ | `telara setup vscode` | Configure VS Code |
78
+ | `telara setup all` | Configure all detected tools at once |
79
+ | `telara init` | Write a project-scoped MCP config for the current directory |
69
80
 
70
81
  ### Contexts
71
82
 
72
- Contexts are named (config + API key) pairs for easy switching between environments.
73
-
74
83
  | Command | Description |
75
84
  |---------|-------------|
76
85
  | `telara context list` | List saved contexts |
77
- | `telara context create <name>` | Create a new context with a generated API key |
78
- | `telara context use <name>` | Switch active context |
86
+ | `telara context create <name>` | Create a context with a generated scoped API key |
87
+ | `telara context use <name>` | Switch the active context |
79
88
  | `telara context current` | Show active context details and MCP URL |
80
- | `telara context delete <name>` | Delete a saved context |
89
+ | `telara context delete <name>` | Remove a saved context |
81
90
 
82
91
  ### Provisioning
83
92
 
84
- Generate MCP access keys for specific deployment scenarios.
85
-
86
93
  | Command | Description |
87
94
  |---------|-------------|
88
- | `telara provision claude-web` | Generate key for Claude.ai (Anthropic Organization Connector) |
89
- | `telara provision ci` | Generate key for CI/CD environments (GitHub Actions, GitLab CI) |
90
- | `telara provision managed` | Generate managed config for enterprise MDM/GPO deployment |
95
+ | `telara provision claude-web` | Key for Claude.ai (Anthropic Organization Connector) |
96
+ | `telara provision ci` | Key for CI/CD environments |
97
+ | `telara provision managed` | Config for enterprise MDM / GPO deployment |
91
98
 
92
99
  ### Diagnostics
93
100
 
94
101
  | Command | Description |
95
102
  |---------|-------------|
96
- | `telara doctor` | Check auth, connectivity, tool configs, contexts, and security |
103
+ | `telara doctor` | Check connectivity, auth, tool configs, and key health |
97
104
  | `telara version` | Print version, commit, and build date |
98
- | `telara update` | Update CLI to the latest version |
105
+ | `telara update` | Self-update to the latest release |
106
+
107
+ ---
99
108
 
100
109
  ## Global flags
101
110
 
102
111
  | Flag | Description |
103
112
  |------|-------------|
104
- | `--api-url` | Override the Telara API base URL |
105
- | `--context` | Use a specific context for this command |
113
+ | `--api-url <url>` | Override the Telara API base URL |
114
+ | `--context <name>` | Use a specific context for this command |
106
115
  | `-v, --verbose` | Print full HTTP responses on errors |
107
116
 
117
+ ---
118
+
108
119
  ## Supported agent tools
109
120
 
110
- - **Claude Code** (global or managed scope)
111
- - **Cursor** (global scope)
112
- - **Windsurf** (global scope)
113
- - **VS Code** (project scope)
121
+ - **Claude Code** — global and managed (enterprise MDM) scope
122
+ - **Cursor** — global scope
123
+ - **Windsurf** — global scope
124
+ - **VS Code** — project scope
125
+
126
+ ---
114
127
 
115
128
  ## Requirements
116
129
 
117
- - Node.js >= 14 (for npm installation)
118
- - macOS, Linux, or Windows
119
- - x86_64 or ARM64 architecture
130
+ - Node.js >= 14
131
+ - macOS, Linux, or Windows (x86_64 or ARM64)
132
+
133
+ ---
120
134
 
121
135
  ## Documentation
122
136
 
123
137
  - [Telara docs](https://telara.dev/docs)
124
- - [CLI installation guide](https://docs.telara.dev/mcp-clients/cli)
125
-
126
- ## License
127
-
128
- MIT
138
+ - [CLI guide](https://docs.telara.dev/mcp-clients/cli)
139
+ - [GitHub](https://github.com/Telara-Labs/Telara-CLI)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@telara-cli/cli",
3
- "version": "0.1.12",
3
+ "version": "0.1.13",
4
4
  "description": "Telara CLI — manage your MCP configurations",
5
5
  "homepage": "https://telara.dev",
6
6
  "repository": {