akta-pro-cli 0.3.0__tar.gz

akta_pro_cli-0.3.0/LICENSE

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

akta_pro_cli-0.3.0/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: akta-pro-cli
+Version: 0.3.0
+Summary: Command-line client for the akta.pro API (api.akta.pro)
+Author-email: Wokelo <support@wokelo.ai>
+Maintainer-email: Wokelo <support@wokelo.ai>
+License: MIT
+Project-URL: Homepage, https://akta.pro/
+Project-URL: Repository, https://github.com/Wokelo-AI/akta-pro-cli
+Keywords: akta-pro,akta.pro,cli,company-intelligence,market-intelligence
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Requires-Dist: typer>=0.12
+Requires-Dist: rich>=13
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: respx>=0.22; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Dynamic: license-file
+
+# akta.pro CLI (`akta-pro`)
+
+A command-line client for the akta.pro REST API (`https://api.akta.pro/api/v1`) — a
+sibling of the akta.pro MCP server. Both are thin clients over the same endpoints;
+the CLI is the presentation layer for humans and shell scripts. It ships as its
+own self-contained distribution (`akta-pro-cli`) with no MCP-server code.
+
+Source: [`src/akta_pro_cli/`](src/akta_pro_cli). API reference: <https://docs.akta.pro>.
+
+## Install
+
+Published on [PyPI](https://pypi.org/project/akta-pro-cli/). Install with `pipx`
+(recommended for CLIs — isolated env) or `pip`:
+
+```bash
+pipx install akta-pro-cli
+# or
+pip install akta-pro-cli
+```
+
+Then run `akta-pro --help`. Full prerequisites, auth, update, and troubleshooting
+steps are in **[INSTALL.md](INSTALL.md)**.
+
+The `akta-pro` command depends only on `httpx`, `typer`, `rich`.
+
+## Authentication
+
+v1 authenticates with an akta.pro API key (`wk_...`), minted at
+<https://playground.akta.pro> (sign up → **API Keys**). Three ways to supply it,
+in precedence order:
+
+```bash
+akta-pro --api-key wk_...  company search Canva     # 1. explicit flag
+export AKTA_PRO_API_KEY=wk_...                       # 2. environment variable
+akta-pro login                                       # 3. stored (prompts, or --api-key)
+```
+
+`akta-pro login` validates the key against a free endpoint and stores it at
+`~/.config/akta-pro/credentials.json` (mode 0600; `%APPDATA%\akta-pro` on Windows).
+
+```bash
+akta-pro login --api-key wk_...   # store without the prompt
+akta-pro whoami                   # show the active key (masked), its source, and validate
+akta-pro logout                   # remove the stored key
+```
+
+## Commands
+
+| Command | Endpoint | Cost | Notes |
+|---|---|---|---|
+| `akta-pro account` | `/mcp/account` | free | your tier + credit balance |
+| `akta-pro company search <query>` | `/company/search` | free | run first; returns `uuid` |
+| `akta-pro company data <company> -s ...` | `/company/enrichment` (JSON; `--markdown` → `/company/enrichment/markdown`) | per section | requires ≥1 `--section` |
+| `akta-pro company concise <company>` | `/company/enrichment/concise` | 8 | slimmed JSON |
+| `akta-pro industry search <query>` | `/industry/search` | free | codes feed `news signals --industry` |
+| `akta-pro news signals [filters]` | `/news` | 0.1 + 0.01/article | anchor with `--company/--industry/--query/--title` (all optional); rich filters (`--country`, `--entity-*`, `--naics/--sic/--iptc/--iab`, `--blacklist`); compact list with `id`s |
+| `akta-pro news detail <id>...` | `/news/by-id/` | 0.1 + 0.01/article | full bodies for ids from `signals` (max 10) |
+| `akta-pro news types` | none (embedded) | free | tag codes for `--type-code`; offline, no key |
+| `akta-pro headcount <company>` | `/company/headcount-trends` | 2.5 | Subscription/Enterprise |
+| `akta-pro traffic <company>` | `/company/website-traffic` | 1.5 | Subscription/Enterprise |
+| `akta-pro jobs <company>` | `/company/jobs` | 3 | Subscription/Enterprise |
+| `akta-pro posts <company>` | `/company/posts` | 1.5 | Subscription/Enterprise |
+| `akta-pro reviews employees <company>` | `/company/employee-reviews` | 1.5/50 | Subscription/Enterprise; `-n/--limit` max 100 |
+| `akta-pro reviews products <company>` | `/company/product-reviews` | 1.5/50 | catalog first, then `--product-id`; `-n/--limit` max 50 per product |
+
+`company data` sections (each billed separately): `firmographic`,
+`business_model`, `company_assessment`, `trust_signal`, `company_hierarchy`,
+`digital_presence`, `financial_estimate`, `location`, `management_profile`,
+`product_offering`, `strategic_signal`, `customer_profile`, `industry`,
+`technology`, plus enterprise-only `funding_detail` (3) and `mna_and_investment`
+(5). There is no "all" — choose explicitly. The two enterprise sections are
+auto-skipped (not an error) for non-enterprise callers, with a note.
+
+Run `akta-pro <command> --help` for every flag.
+
+### Examples
+
+```bash
+akta-pro account                                                  # check tier + credits
+akta-pro company search "Canva"
+akta-pro company data canva.com -s firmographic -s technology     # rendered Markdown
+akta-pro company data canva.com -s firmographic --raw             # raw Markdown (pipe/save)
+akta-pro industry search "warehouse automation"
+akta-pro news types                                               # find type codes
+akta-pro news signals --company canva.com -t SD01 -n 20           # product-launch news
+akta-pro news signals --query "crude oil prices" --json | jq '.data[].id'
+akta-pro news detail 12345 12346                                  # full bodies for those ids
+akta-pro headcount canva.com
+akta-pro reviews products canva.com                               # list catalog + ids
+akta-pro reviews products canva.com --product-id p_123 -n 50
+```
+
+## Output & exit codes
+
+- **Default (TTY):** a Rich table for list results (search, industry, news),
+  rendered Markdown for `company data`, and pretty-printed JSON for nested
+  objects.
+- **`--json`:** clean, unstyled JSON on **stdout** (valid for `| jq`). Applied
+  automatically when stdout is piped/redirected. For `company data`, `--json`
+  (alias `--raw`) emits the raw Markdown.
+- **`-o/--output FILE`:** writes the raw JSON/text payload to a file.
+- **`credits_consumed`** is printed to **stderr** (silence with `-q/--quiet`),
+  so it never pollutes piped JSON.
+
+Exit codes: `0` success · `2` bad input · `3` auth (no/invalid key or `403`) ·
+`4` other API/network error · `5` timeout.

akta_pro_cli-0.3.0/README.md

@@ -0,0 +1,106 @@
+# akta.pro CLI (`akta-pro`)
+
+A command-line client for the akta.pro REST API (`https://api.akta.pro/api/v1`) — a
+sibling of the akta.pro MCP server. Both are thin clients over the same endpoints;
+the CLI is the presentation layer for humans and shell scripts. It ships as its
+own self-contained distribution (`akta-pro-cli`) with no MCP-server code.
+
+Source: [`src/akta_pro_cli/`](src/akta_pro_cli). API reference: <https://docs.akta.pro>.
+
+## Install
+
+Published on [PyPI](https://pypi.org/project/akta-pro-cli/). Install with `pipx`
+(recommended for CLIs — isolated env) or `pip`:
+
+```bash
+pipx install akta-pro-cli
+# or
+pip install akta-pro-cli
+```
+
+Then run `akta-pro --help`. Full prerequisites, auth, update, and troubleshooting
+steps are in **[INSTALL.md](INSTALL.md)**.
+
+The `akta-pro` command depends only on `httpx`, `typer`, `rich`.
+
+## Authentication
+
+v1 authenticates with an akta.pro API key (`wk_...`), minted at
+<https://playground.akta.pro> (sign up → **API Keys**). Three ways to supply it,
+in precedence order:
+
+```bash
+akta-pro --api-key wk_...  company search Canva     # 1. explicit flag
+export AKTA_PRO_API_KEY=wk_...                       # 2. environment variable
+akta-pro login                                       # 3. stored (prompts, or --api-key)
+```
+
+`akta-pro login` validates the key against a free endpoint and stores it at
+`~/.config/akta-pro/credentials.json` (mode 0600; `%APPDATA%\akta-pro` on Windows).
+
+```bash
+akta-pro login --api-key wk_...   # store without the prompt
+akta-pro whoami                   # show the active key (masked), its source, and validate
+akta-pro logout                   # remove the stored key
+```
+
+## Commands
+
+| Command | Endpoint | Cost | Notes |
+|---|---|---|---|
+| `akta-pro account` | `/mcp/account` | free | your tier + credit balance |
+| `akta-pro company search <query>` | `/company/search` | free | run first; returns `uuid` |
+| `akta-pro company data <company> -s ...` | `/company/enrichment` (JSON; `--markdown` → `/company/enrichment/markdown`) | per section | requires ≥1 `--section` |
+| `akta-pro company concise <company>` | `/company/enrichment/concise` | 8 | slimmed JSON |
+| `akta-pro industry search <query>` | `/industry/search` | free | codes feed `news signals --industry` |
+| `akta-pro news signals [filters]` | `/news` | 0.1 + 0.01/article | anchor with `--company/--industry/--query/--title` (all optional); rich filters (`--country`, `--entity-*`, `--naics/--sic/--iptc/--iab`, `--blacklist`); compact list with `id`s |
+| `akta-pro news detail <id>...` | `/news/by-id/` | 0.1 + 0.01/article | full bodies for ids from `signals` (max 10) |
+| `akta-pro news types` | none (embedded) | free | tag codes for `--type-code`; offline, no key |
+| `akta-pro headcount <company>` | `/company/headcount-trends` | 2.5 | Subscription/Enterprise |
+| `akta-pro traffic <company>` | `/company/website-traffic` | 1.5 | Subscription/Enterprise |
+| `akta-pro jobs <company>` | `/company/jobs` | 3 | Subscription/Enterprise |
+| `akta-pro posts <company>` | `/company/posts` | 1.5 | Subscription/Enterprise |
+| `akta-pro reviews employees <company>` | `/company/employee-reviews` | 1.5/50 | Subscription/Enterprise; `-n/--limit` max 100 |
+| `akta-pro reviews products <company>` | `/company/product-reviews` | 1.5/50 | catalog first, then `--product-id`; `-n/--limit` max 50 per product |
+
+`company data` sections (each billed separately): `firmographic`,
+`business_model`, `company_assessment`, `trust_signal`, `company_hierarchy`,
+`digital_presence`, `financial_estimate`, `location`, `management_profile`,
+`product_offering`, `strategic_signal`, `customer_profile`, `industry`,
+`technology`, plus enterprise-only `funding_detail` (3) and `mna_and_investment`
+(5). There is no "all" — choose explicitly. The two enterprise sections are
+auto-skipped (not an error) for non-enterprise callers, with a note.
+
+Run `akta-pro <command> --help` for every flag.
+
+### Examples
+
+```bash
+akta-pro account                                                  # check tier + credits
+akta-pro company search "Canva"
+akta-pro company data canva.com -s firmographic -s technology     # rendered Markdown
+akta-pro company data canva.com -s firmographic --raw             # raw Markdown (pipe/save)
+akta-pro industry search "warehouse automation"
+akta-pro news types                                               # find type codes
+akta-pro news signals --company canva.com -t SD01 -n 20           # product-launch news
+akta-pro news signals --query "crude oil prices" --json | jq '.data[].id'
+akta-pro news detail 12345 12346                                  # full bodies for those ids
+akta-pro headcount canva.com
+akta-pro reviews products canva.com                               # list catalog + ids
+akta-pro reviews products canva.com --product-id p_123 -n 50
+```
+
+## Output & exit codes
+
+- **Default (TTY):** a Rich table for list results (search, industry, news),
+  rendered Markdown for `company data`, and pretty-printed JSON for nested
+  objects.
+- **`--json`:** clean, unstyled JSON on **stdout** (valid for `| jq`). Applied
+  automatically when stdout is piped/redirected. For `company data`, `--json`
+  (alias `--raw`) emits the raw Markdown.
+- **`-o/--output FILE`:** writes the raw JSON/text payload to a file.
+- **`credits_consumed`** is printed to **stderr** (silence with `-q/--quiet`),
+  so it never pollutes piped JSON.
+
+Exit codes: `0` success · `2` bad input · `3` auth (no/invalid key or `403`) ·
+`4` other API/network error · `5` timeout.

akta_pro_cli-0.3.0/pyproject.toml

@@ -0,0 +1,62 @@
+[project]
+name = "akta-pro-cli"
+description = "Command-line client for the akta.pro API (api.akta.pro)"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [{ name = "Wokelo", email = "support@wokelo.ai" }]
+maintainers = [{ name = "Wokelo", email = "support@wokelo.ai" }]
+keywords = ["akta-pro", "akta.pro", "cli", "company-intelligence", "market-intelligence"]
+classifiers = [
+    "License :: OSI Approved :: MIT License",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "httpx>=0.27",
+    "typer>=0.12",
+    "rich>=13",
+]
+dynamic = ["version"]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "respx>=0.22",
+    "ruff>=0.6",
+]
+
+[project.urls]
+Homepage = "https://akta.pro/"
+Repository = "https://github.com/Wokelo-AI/akta-pro-cli"
+
+[project.scripts]
+akta-pro = "akta_pro_cli.__main__:main"
+
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.dynamic]
+version = { attr = "akta_pro_cli.__version__" }
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+ignore = [
+    "E501",   # line length — long help strings; left to the formatter
+    "UP042",  # keep explicit `str, Enum` (avoids StrEnum's str() behaviour change)
+]

akta_pro_cli-0.3.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

akta_pro_cli-0.3.0/src/akta_pro_cli/__init__.py

@@ -0,0 +1,8 @@
+"""akta.pro CLI — a command-line client for the akta.pro REST API (https://api.akta.pro).
+
+A standalone client (its own `akta-pro-cli` distribution) exposing the `akta-pro`
+console command; a sibling of the akta.pro MCP server over the same `/api/v1`
+endpoints, with no MCP-server code.
+"""
+
+__version__ = "0.3.0"

akta_pro_cli-0.3.0/src/akta_pro_cli/__main__.py

@@ -0,0 +1,25 @@
+"""Entry point for `akta-pro` and `python -m akta_pro_cli`.
+
+Lazily imports the Typer app so a broken/partial install prints a helpful hint
+instead of an ImportError traceback.
+"""
+
+from __future__ import annotations
+
+import sys
+
+
+def main() -> None:
+    try:
+        from akta_pro_cli.app import app
+    except ModuleNotFoundError as exc:  # e.g. a broken install missing typer/rich
+        sys.stderr.write(
+            f"The akta.pro CLI is missing a dependency ({exc.name}).\n"
+            "Reinstall with:  pipx install akta-pro-cli\n"
+        )
+        raise SystemExit(1) from exc
+    app()
+
+
+if __name__ == "__main__":
+    main()

akta_pro_cli-0.3.0/src/akta_pro_cli/app.py

@@ -0,0 +1,94 @@
+"""Assembles the `akta-pro` Typer application: root callback + command tree."""
+
+from __future__ import annotations
+
+from typing import Annotated
+
+import typer
+
+from akta_pro_cli import __version__
+from akta_pro_cli.client import DEFAULT_BASE_URL
+from akta_pro_cli.commands import (
+    account,
+    alternative,
+    auth,
+    company,
+    config,
+    industry,
+    news,
+    update,
+)
+from akta_pro_cli.console import err, out
+from akta_pro_cli.runtime import AppContext
+
+app = typer.Typer(
+    no_args_is_help=True,
+    add_completion=True,
+    rich_markup_mode="rich",
+    help="akta.pro CLI — company & market intelligence from api.akta.pro.",
+    epilog="Auth: set AKTA_PRO_API_KEY, pass --api-key, or run `akta-pro login`. Docs: https://docs.akta.pro",
+)
+
+
+def _version_callback(value: bool) -> None:
+    if value:
+        out.print(f"akta-pro {__version__}")
+        # Best-effort, cached (~daily) hint — interactive only, to stderr so it
+        # never pollutes a scripted `akta-pro --version`. Never blocks or errors.
+        if out.is_terminal:
+            try:
+                from akta_pro_cli.update import cached_latest, is_newer
+
+                latest = cached_latest(timeout=2.0)
+                if latest and is_newer(latest, __version__):
+                    err.print(f"[dim]A newer version v{latest} is available — run `akta-pro update`.[/]")
+            except Exception:
+                pass
+        raise typer.Exit()
+
+
+@app.callback()
+def main(
+    ctx: typer.Context,
+    api_key: Annotated[
+        str | None,
+        typer.Option("--api-key", envvar="AKTA_PRO_API_KEY", show_default=False, help="akta.pro API key (wk_...)."),
+    ] = None,
+    base_url: Annotated[
+        str | None,
+        typer.Option(
+            "--base-url",
+            envvar="AKTA_PRO_API_BASE_URL",
+            show_default=False,
+            help=f"Override the API base URL (default {DEFAULT_BASE_URL}; or persist it via `akta-pro login --base-url …`).",
+        ),
+    ] = None,
+    quiet: Annotated[
+        bool,
+        typer.Option("--quiet", "-q", help="Suppress the credits line on stderr."),
+    ] = False,
+    timeout: Annotated[
+        float,
+        typer.Option("--timeout", help="HTTP request timeout in seconds."),
+    ] = 30.0,
+    version: Annotated[
+        bool | None,
+        typer.Option("--version", callback=_version_callback, is_eager=True, help="Show version and exit."),
+    ] = None,
+) -> None:
+    """Global options. Pass these before the command, e.g. `akta-pro --api-key wk_… company search Canva`."""
+    ctx.obj = AppContext(api_key=api_key, base_url=base_url, quiet=quiet, timeout=timeout)
+
+
+# Command groups
+app.add_typer(company.app, name="company")
+app.add_typer(industry.app, name="industry")
+app.add_typer(news.app, name="news")          # signals, detail, types
+app.add_typer(alternative.reviews_app, name="reviews")
+
+# Top-level commands
+auth.register(app)          # login, logout, whoami
+account.register(app)       # account
+config.register(app)        # config show / base-url
+update.register(app)        # update (self-update / check)
+alternative.register(app)   # headcount, traffic, jobs, posts

akta_pro_cli-0.3.0/src/akta_pro_cli/client.py

@@ -0,0 +1,102 @@
+"""Standalone synchronous HTTP client for the akta.pro REST API.
+
+Deliberately self-contained (no dependency on `akta_mcp.*`): the server's
+`AktaClient` reads its key from a request-scoped ContextVar set by the OAuth
+middleware and transitively imports the Redis/Postgres token stores, none of
+which a CLI wants. This mirrors the server's error handling and redirect
+behaviour but takes the API key explicitly and runs synchronously.
+"""
+
+from __future__ import annotations
+
+import httpx
+
+from . import __version__
+
+DEFAULT_BASE_URL = "https://api.akta.pro/api/v1"
+
+# Sent on every request so the backend can distinguish (and version-track) CLI
+# traffic. Mirrors the MCP's `X-Client-Source: AKTA-MCP`.
+CLIENT_SOURCE = f"AKTA-PRO-CLI/{__version__}"
+
+
+class AktaAPIError(RuntimeError):
+    """An HTTP error from the akta.pro API, preserving the status code and body."""
+
+    def __init__(self, message: str, *, status_code: int, body: dict | None = None):
+        super().__init__(message)
+        self.status_code = status_code
+        self.body = body
+
+
+_ERROR_MESSAGES = {
+    400: "Bad request — check the parameters.",
+    401: "Authentication failed. Check your API key (`akta-pro login`).",
+    403: (
+        "Access denied — your plan or credit balance does not cover this data "
+        "(alternative signals require Subscription/Enterprise; Funding and M&A "
+        "sections are enterprise-only)."
+    ),
+    404: "Not found.",
+    429: "Rate limit exceeded. Retry with backoff.",
+    500: "akta.pro server error. Please try again later.",
+    502: "akta.pro service unavailable. Please retry.",
+    503: "akta.pro service unavailable. Please retry.",
+}
+
+
+def _sanitize_http_error(exc: httpx.HTTPStatusError) -> AktaAPIError:
+    status = exc.response.status_code
+    msg = _ERROR_MESSAGES.get(status, f"Request failed with status {status}.")
+    try:
+        body = exc.response.json()
+    except ValueError:
+        body = None
+    if isinstance(body, dict):
+        detail = body.get("detail") or body.get("message") or body.get("error")
+        if detail:
+            msg = f"{msg} ({detail})"
+    return AktaAPIError(msg, status_code=status, body=body if isinstance(body, dict) else None)
+
+
+def _clean(params: dict | None) -> dict:
+    # Drop unset optional params so they aren't serialized onto the query string.
+    return {k: v for k, v in (params or {}).items() if v is not None}
+
+
+class AktaClient:
+    """Thin synchronous httpx wrapper that sends `x-api-key` on every GET."""
+
+    def __init__(self, base_url: str, api_key: str, timeout: float = 30.0):
+        self._api_key = api_key
+        # follow_redirects: several akta.pro routes are declared with a trailing slash,
+        # so a slashless path 307-redirects to the canonical one. The redirect is
+        # same-origin, so x-api-key is re-sent.
+        self._http = httpx.Client(base_url=base_url, timeout=timeout, follow_redirects=True)
+
+    def _headers(self) -> dict:
+        return {"x-api-key": self._api_key, "X-Client-Source": CLIENT_SOURCE}
+
+    def get(self, path: str, params: dict | None = None):
+        """GET, returning parsed JSON when the response is JSON, else raw text.
+
+        Text is returned for Akta's server-rendered Markdown endpoints (e.g.
+        `/company/enrichment/markdown`).
+        """
+        resp = self._http.get(path, params=_clean(params), headers=self._headers())
+        try:
+            resp.raise_for_status()
+        except httpx.HTTPStatusError as exc:
+            raise _sanitize_http_error(exc) from None
+        if "json" in resp.headers.get("content-type", "").lower():
+            return resp.json()
+        return resp.text
+
+    def close(self) -> None:
+        self._http.close()
+
+    def __enter__(self) -> AktaClient:
+        return self
+
+    def __exit__(self, *exc: object) -> None:
+        self.close()

akta_pro_cli-0.3.0/src/akta_pro_cli/commands/__init__.py

@@ -0,0 +1 @@
+"""akta.pro CLI command modules."""

akta_pro_cli-0.3.0/src/akta_pro_cli/commands/account.py

@@ -0,0 +1,35 @@
+"""`akta-pro account` — the caller's plan tier and credit balance."""
+
+from __future__ import annotations
+
+import typer
+from rich.table import Table
+
+from akta_pro_cli.options import JsonOpt, OutOpt
+from akta_pro_cli.runtime import emit, fetch
+
+
+def _account_table(result: object) -> Table | None:
+    if not isinstance(result, dict):
+        return None
+    table = Table(title="akta.pro account", show_header=False)
+    table.add_column("Field", style="bold")
+    table.add_column("Value")
+    for key in ("package_type", "is_enterprise", "credit_balance", "currency"):
+        if key in result:
+            table.add_row(key.replace("_", " ").title(), str(result[key]))
+    return table
+
+
+def account(ctx: typer.Context, json_out: JsonOpt = False, output: OutOpt = None) -> None:
+    """Show your plan tier (is_enterprise, package_type) and credit balance (free).
+
+    Check this before Subscription/Enterprise-only commands (headcount, traffic,
+    jobs, posts, reviews) to know whether they'll be allowed.
+    """
+    result = fetch(ctx.obj, "/mcp/account")
+    emit(ctx.obj, result, json_out=json_out, output=output, renderer=_account_table)
+
+
+def register(app: typer.Typer) -> None:
+    app.command("account")(account)