nexla-cli 0.2.0__py3-none-any.whl

nexla_cli-0.2.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,38 @@
+nexla_cli/AGENTS.md,sha256=1IfbtoCTJ13Cgcxyu1oKTZeqwE92ui9lqqSGYELaVtc,15582
+nexla_cli/SKILL.md,sha256=Ssvw7ZeZ0Yoki38L-u0TdBqEgitkWofgWMLBoidcg3k,8082
+nexla_cli/__init__.py,sha256=Wn9kr9_BkAysU_p91rSNpQPcb2clTQySEQlrOeHoCnE,8674
+nexla_cli/client.py,sha256=I5zK4qSUrOFUm0a3L1IVKMuOFuvHSE1BgVgMSe1eDBg,4216
+nexla_cli/dryrun.py,sha256=mcXfb81RcDHWCEH9Q4b2u7VPn2R2JVYmvcvV2RVEpH4,4948
+nexla_cli/errors.py,sha256=UsKUkrOTNnenN7u5fga6YcwWk8NsRtDWu96zImqeKKU,1414
+nexla_cli/login.py,sha256=sZ6cMtLZiBZ8MgLNkxSkWsK1O1a0NfspJeosyr0tmK8,1407
+nexla_cli/mcp_client.py,sha256=MjnfrBXF6QvpRDKuTjAKMGJKxpOXidMCcPAJhtOg8_w,5385
+nexla_cli/openapi_client.py,sha256=0S2Zm7DZNoU0QVHS51WfZ-q_vGWOosAvHFcRy5Cp6Jc,9837
+nexla_cli/output.py,sha256=rdpGVyaQzTQNxkiQVe0zqLUuCW5NFBci_gWUbSGu9cc,4667
+nexla_cli/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nexla_cli/sanitize.py,sha256=YY5mBS6XqzF9THPaEf-4sZaJeFDU9CWGAJ3keWTiVW4,3525
+nexla_cli/schema.py,sha256=bR_hQD7ALV_pX8FWTfHWVmU1rpysUiuIooZ0uprWL3Q,2274
+nexla_cli/validate.py,sha256=WogtnE9OCnEBTIFswvE_xD_HFP752pVzOigPIAMIAFg,4244
+nexla_cli/resources/__init__.py,sha256=xTaScx5-ueEoVPbNQU8fa7FZb-w7d7iX0wQ7xvfkDG8,75
+nexla_cli/resources/code_containers.py,sha256=_qfsZj_4Ept7K28JAMPr4aA9tKIQ8lMr_2qJIZ3jJuQ,682
+nexla_cli/resources/connectors.py,sha256=Pwx-tcGtZx7mHJ3xzL1vL_pDdxRkE1Ec1ryHjZTi3Og,4303
+nexla_cli/resources/context.py,sha256=9wqvAYsy64cTI7DP6wO06zflrF-iGsH9GyTC4AZYwaY,618
+nexla_cli/resources/credentials.py,sha256=uF2z03EjQDYxjA0xNxR-jt9J4mvue9rQP0mMGeYgROI,4314
+nexla_cli/resources/flows.py,sha256=zseeF4CJ9bP8IlWIV38Mm5bic0Gq1pIo8Tixdckk7Vg,2895
+nexla_cli/resources/mcp_servers.py,sha256=RoraZcXL7hMJabBS7lYDim6xm13kxBUmGwdZlSZfR8A,3799
+nexla_cli/resources/metrics.py,sha256=CZwmPg4V91lqB3ZlRAX6Xx18rRGDlP_cOlyxy57uvdQ,1584
+nexla_cli/resources/nexsets.py,sha256=WnOUl-paUFiDowT8BvIpwI7zEl3_nI2B51tkHeu0IDE,3707
+nexla_cli/resources/notifications.py,sha256=6pBDzpL72sUqYOdgYK_dG588Mdk5WrZtdDUME2fwbzQ,582
+nexla_cli/resources/orgs.py,sha256=7ILZ-Oqox08tQOqAaoQ_eXEanqlCC4DfC5nFH3SN3ic,1737
+nexla_cli/resources/probe.py,sha256=bv7zDDTZL62a3tl6vgRQqiUvOpiFONllVC732W0SnAk,4164
+nexla_cli/resources/sinks.py,sha256=oKqlfJzC9HSVIkXMQQq-mtdstFqqr4HX30bYWYlrbMI,9019
+nexla_cli/resources/sources.py,sha256=CBtiCI1NON4U2qNLAnxUrwF5zxQWkvXV-Z0dHoVXvbQ,6593
+nexla_cli/resources/tools.py,sha256=z6SWJo7BZ5gTp19i6uLOntDGa_fHCatiIbv69xcWuTU,3509
+nexla_cli/resources/toolsets.py,sha256=-_0LlvGT89FfnVYwN54y16QD_5Gs31nVp3YwRYY95iM,4302
+nexla_cli/resources/transforms.py,sha256=9iur9ahJLuDK4jjAXCO_ts646Ux4v8Ze-hqlyLU2650,1236
+nexla_cli/resources/triage.py,sha256=yEcKZwcl58FmiRNatHJ3rAnQuo3wTfNaWYva2RA57pg,7635
+nexla_cli/resources/users.py,sha256=eaRsVCFlAq5O2-RW7hQ9WKjvm12-M_SBDJ1J05SX4SQ,821
+nexla_cli-0.2.0.dist-info/METADATA,sha256=GtuqrbEtlh7lVGruye8xvfMU7cZt2xKA5XFrLRotd0E,8862
+nexla_cli-0.2.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+nexla_cli-0.2.0.dist-info/entry_points.txt,sha256=h_igc2DUbV0B_9-CZ58PqsltJkDJQXn1J0wuhzsKWVc,41
+nexla_cli-0.2.0.dist-info/licenses/LICENSE,sha256=7SR4B6WYbq0NvNxasPW7DT67DipyIQ5Udl8Nz6oOXuE,1071
+nexla_cli-0.2.0.dist-info/RECORD,,

nexla_cli-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

nexla_cli-0.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+nexla = nexla_cli:main

nexla_cli-0.2.0.dist-info/licenses/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.