nexla-cli 0.2.0__tar.gz

nexla_cli-0.2.0/.github/workflows/publish-pypi.yml

@@ -0,0 +1,34 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write # required for PyPI Trusted Publishing (OIDC)
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install build
+      - run: python -m build
+
+      # Preferred: PyPI Trusted Publishing. Requires a one-time setup on
+      # pypi.org (project nexla-cli -> Settings -> Publishing -> add this
+      # repo + workflow filename + "pypi" environment as a trusted
+      # publisher) -- see README.md's "Publishing to PyPI" section. No
+      # secret/token needed here.
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+      # Optional fallback if Trusted Publishing isn't set up yet: uncomment
+      # and set `password` from a repo secret (e.g. PYPI_API_TOKEN) instead
+      # of relying on OIDC. Not used by default.
+      # - uses: pypa/gh-action-pypi-publish@release/v1
+      #   with:
+      #     password: ${{ secrets.PYPI_API_TOKEN }}

nexla_cli-0.2.0/.github/workflows/release-binaries.yml

@@ -0,0 +1,44 @@
+name: Release binaries
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+jobs:
+  build:
+    strategy:
+      matrix:
+        include:
+          - os: ubuntu-latest
+            asset: nexla-linux-x64
+          - os: macos-latest
+            asset: nexla-macos-arm64
+          - os: windows-latest
+            asset: nexla-windows-x64.exe
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install . pyinstaller
+      - run: >
+          pyinstaller --onefile --name ${{ matrix.asset }}
+          scripts/pyinstaller_entry.py
+      - uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.asset }}
+          path: dist/${{ matrix.asset }}
+
+  release:
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: dist
+          merge-multiple: true
+      - uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*

nexla_cli-0.2.0/.gitignore

@@ -0,0 +1,14 @@
+__pycache__/
+*.pyc
+.venv/
+dist/
+*.egg-info/
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.claude/
+plans/
+npm/bin/nexla-bin*
+npm/node_modules/
+build/
+*.spec

nexla_cli-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Abhishek Kumar
+
+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.

nexla_cli-0.2.0/PKG-INFO

@@ -0,0 +1,196 @@
+Metadata-Version: 2.4
+Name: nexla-cli
+Version: 0.2.0
+Summary: Command-line client for the Nexla agent API.
+Project-URL: Homepage, https://github.com/abhishekkumar705/nexla-agent-cli
+Project-URL: Repository, https://github.com/abhishekkumar705/nexla-agent-cli
+Project-URL: Issues, https://github.com/abhishekkumar705/nexla-agent-cli/issues
+Author-email: Abhishek Kumar <abhishek.kumar@nexla.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.13.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=1.3.0; extra == 'dev'
+Requires-Dist: pytest>=9.0.3; extra == 'dev'
+Requires-Dist: respx>=0.23.1; extra == 'dev'
+Requires-Dist: ruff>=0.15.12; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# nexla-cli
+
+Command-line client for the Nexla agent API. Depends on only `typer` and
+`httpx` — no FastAPI, Daytona, Supabase, or other backend dependencies.
+
+## Install
+
+```bash
+pipx install "git+https://github.com/abhishekkumar705/nexla-agent-cli.git"
+```
+
+Or with `uv`:
+
+```bash
+uv tool install "git+https://github.com/abhishekkumar705/nexla-agent-cli.git"
+```
+
+### From Node/TypeScript projects (no Python required)
+
+```bash
+npm install -g nexla-cli
+# or run once-off:
+npx nexla-cli sources list
+```
+
+This installs a prebuilt native binary (published to GitHub Releases by
+`.github/workflows/release-binaries.yml`) behind a thin `npm/` wrapper — no
+Python interpreter needed on the target machine. See `npm/README.md` for how
+releases are cut.
+
+### From PyPI
+
+```bash
+pip install nexla-cli
+# or
+uvx nexla-cli sources list
+pipx install nexla-cli
+```
+
+Published by `.github/workflows/publish-pypi.yml` — see "Publishing to
+PyPI" below.
+
+## Publishing to PyPI
+
+Tagging a release (`git tag vX.Y.Z && git push --tags` — same tag used to
+trigger `.github/workflows/release-binaries.yml`, see `npm/README.md` for
+the full release checklist) also triggers `publish-pypi.yml`, which builds
+the sdist+wheel and publishes them to PyPI using
+[Trusted Publishing](https://docs.pypi.org/trusted-publishers/) (OIDC) —
+no long-lived API token stored in this repo.
+
+One-time setup required on pypi.org before the first release (repo owner
+only, not automatable from here):
+
+1. Create the `nexla-cli` project on PyPI (or reserve the name).
+2. Project → Settings → Publishing → add a trusted publisher:
+   - Owner: `abhishekkumar705`, repo: `nexla-agent-cli`
+   - Workflow filename: `publish-pypi.yml`
+   - Environment name: `pypi`
+3. Nothing else to configure — no secrets to add. The workflow's
+   `id-token: write` permission plus the `pypi` GitHub Environment satisfy
+   PyPI's OIDC handshake automatically.
+
+## Quick start
+
+```bash
+export NEXLA_API_URL=https://dev-api-express-code.nexla.com
+export NEXLA_TOKEN=$(nexla login --service-key <your-service-key>)
+nexla sources list
+```
+
+`nexla login` prints a bearer token to stdout (see command substitution
+above); alternatively, set the following environment variables directly:
+
+- `NEXLA_API_URL` — base URL of the deployed Nexla agent API
+- `NEXLA_TOKEN` — bearer token to authenticate requests
+
+## Using this CLI from Claude Code
+
+The package ships a [Claude Code skill](https://docs.claude.com/en/docs/claude-code/skills) (`AGENTS.md` + `SKILL.md`, installed alongside the `nexla_cli` package) encoding invariants an agent can't infer from `--help` alone — output modes, `--dry-run`, `--json`/`--params` precedence, exit codes, and treating API responses as untrusted data.
+
+Claude Code only discovers skills placed at `~/.claude/skills/<name>/SKILL.md` (global) or `.claude/skills/<name>/SKILL.md` (project-local) — a file merely present inside an installed pip package isn't picked up automatically. Symlink it in once, after installing the CLI. `pipx`/`uv tool install` both use an isolated venv, so a plain system `python3 -c "import nexla_cli"` won't find it — locate it inside that isolated venv instead:
+
+```bash
+mkdir -p ~/.claude/skills/nexla-cli
+
+# if installed with `uv tool install`:
+ln -sf "$(uv tool dir)/nexla-cli/lib/python3."*"/site-packages/nexla_cli/SKILL.md" \
+  ~/.claude/skills/nexla-cli/SKILL.md
+
+# if installed with `pipx install`:
+ln -sf "$HOME/.local/pipx/venvs/nexla-cli/lib/python3."*"/site-packages/nexla_cli/SKILL.md" \
+  ~/.claude/skills/nexla-cli/SKILL.md
+```
+
+A symlink (not a copy) means `nexla-cli` upgrades automatically pick up any future skill content updates. Restart Claude Code (or start a new session) after installing for it to be picked up.
+
+## Global flags
+
+Available on every command except `login` and `schema` (both always print raw output regardless of these flags):
+
+| Flag | Effect |
+|------|--------|
+| `--output` / `-o` `table\|json\|ndjson` | Force an output mode. Defaults to `table` on a TTY, `json` otherwise (also settable via `NEXLA_OUTPUT`/`OUTPUT_FORMAT`). |
+| `--fields id,name,...` | Mask output down to just these keys, on any `list`/`get`. |
+| `--page-all` | Stream every page of a `list` command as NDJSON instead of returning one page. |
+
+These can be placed before or after the subcommand, e.g. both `nexla --output json sources list` and `nexla sources list --output json` work.
+
+Every mutating command also accepts `--dry-run`: validates the request body against the live API schema and prints `{"valid": ...}` without making the real (mutating) call.
+
+## Raw JSON payloads
+
+`create`/`update`-style commands (`sources`, `sinks`, `credentials`, `toolsets`, `nexsets transform`, `mcp-servers attach`, `tools set-runtime-config`) accept the full request body directly, not just their named flags:
+
+```bash
+nexla sources create --name my-source --connector s3 --json '{"credential_id": 123}'
+nexla sources update 42 --params description="updated via params"
+```
+
+Precedence when a key is given more than one way: named CLI flags win, then `--json`, then `--params` (lowest). This lets you set a field the CLI hasn't added a dedicated flag for yet, without waiting on a CLI release.
+
+## Response sanitization
+
+Every response is passed through a sanitizer before rendering, in every output mode: ANSI escape sequences, control characters, and invisible Unicode (zero-width spaces, byte-order marks, bidirectional overrides) are stripped unconditionally — always on, no flag. This defends against a malicious API response field hijacking a human's terminal, or hiding text from a human while an agent still reads it. It is not a semantic filter — API response *content* should still be treated as untrusted data (see `AGENTS.md`), this only strips characters no legitimate field value would ever need.
+
+## Full command reference
+
+```bash
+nexla --help
+nexla <resource> --help
+```
+
+| Resource | Commands |
+|----------|----------|
+| `login` | `login --service-key <key> [--api-url <url>]` — exchanges a service key for a bearer token, printed to stdout |
+| `schema` | `schema [<resource>.<verb>]` — machine-readable JSON signature of one command or the whole `/nexla/*` surface, fetched live from the deployed API's OpenAPI doc |
+| `sources` | `list`, `get`, `create`, `update`, `activate`, `pause`, `delete`, `sample`, `file-upload` |
+| `sinks` | `list`, `get`, `create`, `update`, `activate`, `pause`, `delete` |
+| `nexsets` | `list`, `get`, `transform`, `activate` |
+| `credentials` | `list`, `get`, `create`, `update`, `delete` |
+| `flows` | `list`, `get`, `activate`, `pause`, `delete` |
+| `transforms` | `test` |
+| `connectors` | `search`, `describe`, `describe-credential`, `describe-credential-mode`, `describe-source`, `describe-source-endpoint`, `describe-sink`, `describe-sink-endpoint` |
+| `probe` | `run` |
+| `toolsets` | `list`, `get`, `create`, `update`, `delete`, `add-nexsets` |
+| `tools` | `list`, `get`, `set-runtime-config`, `clear-runtime-config`, `delete` |
+| `mcp-servers` | `list`, `attach`, `sync`, `detach` (nested under a toolset) |
+| `context` | `get` |
+| `orgs` | `list`, `get` |
+| `code-containers` | `list` |
+| `metrics` | `catalog`, `for-resource`, `get` |
+| `users` | `list`, `get` |
+| `notifications` | `list` |
+
+`code-containers`, `metrics`, `users`, and `notifications` proxy resources the API hasn't implemented yet (they return HTTP 501 until it does).
+
+## Exit codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | success |
+| 2 | bad local input (validation, `--dry-run` failure) |
+| 3 | `NEXLA_API_URL`/`NEXLA_TOKEN` not set |
+| 4 | 401/403 from the API |
+| 5 | 404 |
+| 6 | 5xx from the API |

nexla_cli-0.2.0/README.md

@@ -0,0 +1,167 @@
+# nexla-cli
+
+Command-line client for the Nexla agent API. Depends on only `typer` and
+`httpx` — no FastAPI, Daytona, Supabase, or other backend dependencies.
+
+## Install
+
+```bash
+pipx install "git+https://github.com/abhishekkumar705/nexla-agent-cli.git"
+```
+
+Or with `uv`:
+
+```bash
+uv tool install "git+https://github.com/abhishekkumar705/nexla-agent-cli.git"
+```
+
+### From Node/TypeScript projects (no Python required)
+
+```bash
+npm install -g nexla-cli
+# or run once-off:
+npx nexla-cli sources list
+```
+
+This installs a prebuilt native binary (published to GitHub Releases by
+`.github/workflows/release-binaries.yml`) behind a thin `npm/` wrapper — no
+Python interpreter needed on the target machine. See `npm/README.md` for how
+releases are cut.
+
+### From PyPI
+
+```bash
+pip install nexla-cli
+# or
+uvx nexla-cli sources list
+pipx install nexla-cli
+```
+
+Published by `.github/workflows/publish-pypi.yml` — see "Publishing to
+PyPI" below.
+
+## Publishing to PyPI
+
+Tagging a release (`git tag vX.Y.Z && git push --tags` — same tag used to
+trigger `.github/workflows/release-binaries.yml`, see `npm/README.md` for
+the full release checklist) also triggers `publish-pypi.yml`, which builds
+the sdist+wheel and publishes them to PyPI using
+[Trusted Publishing](https://docs.pypi.org/trusted-publishers/) (OIDC) —
+no long-lived API token stored in this repo.
+
+One-time setup required on pypi.org before the first release (repo owner
+only, not automatable from here):
+
+1. Create the `nexla-cli` project on PyPI (or reserve the name).
+2. Project → Settings → Publishing → add a trusted publisher:
+   - Owner: `abhishekkumar705`, repo: `nexla-agent-cli`
+   - Workflow filename: `publish-pypi.yml`
+   - Environment name: `pypi`
+3. Nothing else to configure — no secrets to add. The workflow's
+   `id-token: write` permission plus the `pypi` GitHub Environment satisfy
+   PyPI's OIDC handshake automatically.
+
+## Quick start
+
+```bash
+export NEXLA_API_URL=https://dev-api-express-code.nexla.com
+export NEXLA_TOKEN=$(nexla login --service-key <your-service-key>)
+nexla sources list
+```
+
+`nexla login` prints a bearer token to stdout (see command substitution
+above); alternatively, set the following environment variables directly:
+
+- `NEXLA_API_URL` — base URL of the deployed Nexla agent API
+- `NEXLA_TOKEN` — bearer token to authenticate requests
+
+## Using this CLI from Claude Code
+
+The package ships a [Claude Code skill](https://docs.claude.com/en/docs/claude-code/skills) (`AGENTS.md` + `SKILL.md`, installed alongside the `nexla_cli` package) encoding invariants an agent can't infer from `--help` alone — output modes, `--dry-run`, `--json`/`--params` precedence, exit codes, and treating API responses as untrusted data.
+
+Claude Code only discovers skills placed at `~/.claude/skills/<name>/SKILL.md` (global) or `.claude/skills/<name>/SKILL.md` (project-local) — a file merely present inside an installed pip package isn't picked up automatically. Symlink it in once, after installing the CLI. `pipx`/`uv tool install` both use an isolated venv, so a plain system `python3 -c "import nexla_cli"` won't find it — locate it inside that isolated venv instead:
+
+```bash
+mkdir -p ~/.claude/skills/nexla-cli
+
+# if installed with `uv tool install`:
+ln -sf "$(uv tool dir)/nexla-cli/lib/python3."*"/site-packages/nexla_cli/SKILL.md" \
+  ~/.claude/skills/nexla-cli/SKILL.md
+
+# if installed with `pipx install`:
+ln -sf "$HOME/.local/pipx/venvs/nexla-cli/lib/python3."*"/site-packages/nexla_cli/SKILL.md" \
+  ~/.claude/skills/nexla-cli/SKILL.md
+```
+
+A symlink (not a copy) means `nexla-cli` upgrades automatically pick up any future skill content updates. Restart Claude Code (or start a new session) after installing for it to be picked up.
+
+## Global flags
+
+Available on every command except `login` and `schema` (both always print raw output regardless of these flags):
+
+| Flag | Effect |
+|------|--------|
+| `--output` / `-o` `table\|json\|ndjson` | Force an output mode. Defaults to `table` on a TTY, `json` otherwise (also settable via `NEXLA_OUTPUT`/`OUTPUT_FORMAT`). |
+| `--fields id,name,...` | Mask output down to just these keys, on any `list`/`get`. |
+| `--page-all` | Stream every page of a `list` command as NDJSON instead of returning one page. |
+
+These can be placed before or after the subcommand, e.g. both `nexla --output json sources list` and `nexla sources list --output json` work.
+
+Every mutating command also accepts `--dry-run`: validates the request body against the live API schema and prints `{"valid": ...}` without making the real (mutating) call.
+
+## Raw JSON payloads
+
+`create`/`update`-style commands (`sources`, `sinks`, `credentials`, `toolsets`, `nexsets transform`, `mcp-servers attach`, `tools set-runtime-config`) accept the full request body directly, not just their named flags:
+
+```bash
+nexla sources create --name my-source --connector s3 --json '{"credential_id": 123}'
+nexla sources update 42 --params description="updated via params"
+```
+
+Precedence when a key is given more than one way: named CLI flags win, then `--json`, then `--params` (lowest). This lets you set a field the CLI hasn't added a dedicated flag for yet, without waiting on a CLI release.
+
+## Response sanitization
+
+Every response is passed through a sanitizer before rendering, in every output mode: ANSI escape sequences, control characters, and invisible Unicode (zero-width spaces, byte-order marks, bidirectional overrides) are stripped unconditionally — always on, no flag. This defends against a malicious API response field hijacking a human's terminal, or hiding text from a human while an agent still reads it. It is not a semantic filter — API response *content* should still be treated as untrusted data (see `AGENTS.md`), this only strips characters no legitimate field value would ever need.
+
+## Full command reference
+
+```bash
+nexla --help
+nexla <resource> --help
+```
+
+| Resource | Commands |
+|----------|----------|
+| `login` | `login --service-key <key> [--api-url <url>]` — exchanges a service key for a bearer token, printed to stdout |
+| `schema` | `schema [<resource>.<verb>]` — machine-readable JSON signature of one command or the whole `/nexla/*` surface, fetched live from the deployed API's OpenAPI doc |
+| `sources` | `list`, `get`, `create`, `update`, `activate`, `pause`, `delete`, `sample`, `file-upload` |
+| `sinks` | `list`, `get`, `create`, `update`, `activate`, `pause`, `delete` |
+| `nexsets` | `list`, `get`, `transform`, `activate` |
+| `credentials` | `list`, `get`, `create`, `update`, `delete` |
+| `flows` | `list`, `get`, `activate`, `pause`, `delete` |
+| `transforms` | `test` |
+| `connectors` | `search`, `describe`, `describe-credential`, `describe-credential-mode`, `describe-source`, `describe-source-endpoint`, `describe-sink`, `describe-sink-endpoint` |
+| `probe` | `run` |
+| `toolsets` | `list`, `get`, `create`, `update`, `delete`, `add-nexsets` |
+| `tools` | `list`, `get`, `set-runtime-config`, `clear-runtime-config`, `delete` |
+| `mcp-servers` | `list`, `attach`, `sync`, `detach` (nested under a toolset) |
+| `context` | `get` |
+| `orgs` | `list`, `get` |
+| `code-containers` | `list` |
+| `metrics` | `catalog`, `for-resource`, `get` |
+| `users` | `list`, `get` |
+| `notifications` | `list` |
+
+`code-containers`, `metrics`, `users`, and `notifications` proxy resources the API hasn't implemented yet (they return HTTP 501 until it does).
+
+## Exit codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | success |
+| 2 | bad local input (validation, `--dry-run` failure) |
+| 3 | `NEXLA_API_URL`/`NEXLA_TOKEN` not set |
+| 4 | 401/403 from the API |
+| 5 | 404 |
+| 6 | 5xx from the API |

nexla_cli-0.2.0/npm/README.md

@@ -0,0 +1,27 @@
+# nexla-cli (npm wrapper)
+
+Thin npm package that installs the prebuilt `nexla` binary — no Python
+required. `postinstall` (`scripts/install.js`) downloads the binary matching
+the current OS/arch from the GitHub release tagged `v<package version>`;
+`bin/nexla.js` execs it and forwards argv/stdio/exit code.
+
+## Cutting a release
+
+1. Bump the version in both `pyproject.toml` and `npm/package.json` — they
+   must match, since `scripts/install.js` derives the release tag from
+   `npm/package.json`'s version.
+2. `git tag vX.Y.Z && git push --tags` — this triggers
+   `.github/workflows/release-binaries.yml`, which builds binaries for
+   macOS (arm64), Linux (x64), and Windows (x64) via PyInstaller and
+   attaches them to the GitHub release.
+3. Once the release assets are up, publish the npm wrapper:
+   ```bash
+   cd npm && npm publish
+   ```
+
+Supported platforms: `darwin-arm64`, `linux-x64`, `win32-x64` (see
+`scripts/install.js`'s `ASSETS` map — add an entry there and a matching
+matrix row in the workflow to support more, e.g. Intel Mac was dropped
+from the matrix due to GitHub's shrinking `macos-13` runner capacity;
+re-add a `macos-13` row + a `darwin-x64` ASSETS entry if that's needed
+again).

nexla_cli-0.2.0/npm/bin/nexla.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+"use strict";
+const path = require("path");
+const { spawnSync } = require("child_process");
+
+const binName = process.platform === "win32" ? "nexla-bin.exe" : "nexla-bin";
+const bin = path.join(__dirname, binName);
+
+const result = spawnSync(bin, process.argv.slice(2), { stdio: "inherit" });
+if (result.error) {
+  console.error(`nexla-cli: could not run bundled binary (${result.error.message})`);
+  process.exit(1);
+}
+process.exit(result.status === null ? 1 : result.status);

nexla_cli-0.2.0/npm/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "nexla-cli",
+  "version": "0.2.0",
+  "description": "Command-line client for the Nexla agent API (native binary, no Python required)",
+  "bin": {
+    "nexla": "bin/nexla.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/install.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/abhishekkumar705/nexla-agent-cli.git"
+  },
+  "license": "MIT",
+  "os": ["darwin", "linux", "win32"],
+  "cpu": ["x64", "arm64"]
+}

nexla_cli-0.2.0/npm/scripts/install.js

@@ -0,0 +1,62 @@
+"use strict";
+// Downloads the prebuilt `nexla` binary matching this machine from the
+// GitHub release tagged to match this package's version.
+const fs = require("fs");
+const path = require("path");
+const https = require("https");
+const pkg = require("../package.json");
+
+const ASSETS = {
+  "darwin-arm64": "nexla-macos-arm64",
+  "linux-x64": "nexla-linux-x64",
+  "win32-x64": "nexla-windows-x64.exe",
+};
+
+const key = `${process.platform}-${process.arch}`;
+const asset = ASSETS[key];
+if (!asset) {
+  console.error(
+    `nexla-cli: no prebuilt binary for ${key}. Supported: ${Object.keys(ASSETS).join(", ")}`
+  );
+  process.exit(1);
+}
+
+const url = `https://github.com/abhishekkumar705/nexla-agent-cli/releases/download/v${pkg.version}/${asset}`;
+const destName = process.platform === "win32" ? "nexla-bin.exe" : "nexla-bin";
+const dest = path.join(__dirname, "..", "bin", destName);
+// Skip download if a binary is already present.
+
+if (fs.existsSync(dest)) {
+  console.log(`nexla-cli: using existing binary at ${dest}`);
+  process.exit(0);
+}
+
+function download(url, redirectsLeft) {
+  return new Promise((resolve, reject) => {
+    https
+      .get(url, (res) => {
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          if (redirectsLeft <= 0) return reject(new Error("too many redirects"));
+          res.resume();
+          return resolve(download(res.headers.location, redirectsLeft - 1));
+        }
+        if (res.statusCode !== 200) {
+          return reject(new Error(`download failed: HTTP ${res.statusCode} for ${url}`));
+        }
+        const file = fs.createWriteStream(dest);
+        res.pipe(file);
+        file.on("finish", () => file.close(resolve));
+        file.on("error", reject);
+      })
+      .on("error", reject);
+  });
+}
+
+download(url, 5)
+  .then(() => {
+    if (process.platform !== "win32") fs.chmodSync(dest, 0o755);
+  })
+  .catch((err) => {
+    console.error(`nexla-cli: failed to download binary from ${url}\n${err.message}`);
+    process.exit(1);
+  });

nexla_cli-0.2.0/pyproject.toml

@@ -0,0 +1,52 @@
+[project]
+name = "nexla-cli"
+version = "0.2.0"
+description = "Command-line client for the Nexla agent API."
+readme = "README.md"
+# Same MIT license already declared for this codebase in npm/package.json.
+license = "MIT"
+authors = [{ name = "Abhishek Kumar", email = "abhishek.kumar@nexla.com" }]
+requires-python = ">=3.12"
+dependencies = ["typer>=0.12.0", "httpx>=0.28.0"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://github.com/abhishekkumar705/nexla-agent-cli"
+Repository = "https://github.com/abhishekkumar705/nexla-agent-cli"
+Issues = "https://github.com/abhishekkumar705/nexla-agent-cli/issues"
+
+[project.scripts]
+nexla = "nexla_cli:main"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=9.0.3",
+    "pytest-asyncio>=1.3.0",
+    "respx>=0.23.1",
+    "ruff>=0.15.12",
+    "mypy>=1.13.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/nexla_cli"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py312"
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]

nexla_cli-0.2.0/scripts/pyinstaller_entry.py

@@ -0,0 +1,4 @@
+from nexla_cli import main
+
+if __name__ == "__main__":
+    main()