From 144c1f606c024f663661504d23a1c60a3cde4b1c Mon Sep 17 00:00:00 2001 From: SimonTarara62 <33222802+SimonTarara62@users.noreply.github.com> Date: Mon, 15 Jun 2026 19:11:01 +0300 Subject: [PATCH 1/3] docs: awesome-list submission tracker (targets, bars, draft entries) --- docs/awesome-submission.md | 38 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 docs/awesome-submission.md diff --git a/docs/awesome-submission.md b/docs/awesome-submission.md new file mode 100644 index 0000000..c005370 --- /dev/null +++ b/docs/awesome-submission.md @@ -0,0 +1,38 @@ +# Awesome-list submission tracker + +Where to get `capitalcom-cli` listed, what each list requires, and the exact +entry text to submit. Keep this in sync when a submission lands. + +## Targets + +### 1. wilsonfreitas/awesome-quant — section "Trading & Backtesting" (Python) +- **Bar:** quality-based — documented, tested, fills a gap. No star/age minimum. +- **Status:** eligible now. +- **Format:** `[name](link) - Python - Description.` +- **Entry to submit:** + `[capitalcom-cli](https://github.com/SimonTarara62/capitalcom-cli) - Python - Unofficial CLI and async SDK for the Capital.com broker API: market data, guarded order execution, and real-time streaming.` +- **How:** fork, add the entry alphabetically/at the end of the "Trading & Backtesting" + list, one entry, PR titled `Add capitalcom-cli`. Verify the live section name and + format before submitting (lists drift). + +### 2. agarrharr/awesome-cli-apps — section "Finance" +- **Bar:** repo **> 90 days old** AND **> 20 GitHub stars**; one entry per PR; + PR titled `Add capctl`; entry appended to the Finance category; + `[name](link) - Description.` (capital start, period end, concise, no "CLI"). +- **Status:** NOT eligible yet. Repo created 2026-06-12 → eligible **≈ 2026-09-10**, + and only once stars ≥ 20. +- **Entry to submit (when eligible):** + `[capctl](https://github.com/SimonTarara62/capitalcom-cli) - Unofficial client for the Capital.com trading API with guarded order execution and real-time streaming.` + +### 3. toolleeo/awesome-cli-apps-in-a-csv — optional, CSV-format, broad inclusion +- **Status:** eligible; lower priority. Follow that repo's CSV row format if pursued. + +## Unofficial positioning (done in this change set) +"Unofficial" is now explicit in: the README title + tagline, the existing risk +disclaimer, the `NOTICE` file, the `pyproject.toml` description (→ PyPI summary), +the GitHub repo "About", and the `capctl --help` text. + +## MCP-safety note +Listing/positioning changes are text-only. The package name (`capital_cli` / +`capitalcom-cli`), the CLI binary (`capctl`), and the SDK public API are unchanged, +so the sibling MCP server that imports `capital_cli.sdk` is unaffected. From 01f82fe398b8a8a6e19b86bfdc8506b977be44d7 Mon Sep 17 00:00:00 2001 From: SimonTarara62 <33222802+SimonTarara62@users.noreply.github.com> Date: Mon, 15 Jun 2026 19:12:14 +0300 Subject: [PATCH 2/3] docs: make the unofficial status explicit in title, package description, and CLI help Co-Authored-By: Claude Opus 4.8 --- README.md | 4 ++-- capital_cli/cli/app.py | 2 +- docs/CLI.md | 2 +- pyproject.toml | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 1208ae5..78c3718 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ -# capctl — Capital.com CLI +# capctl — unofficial Capital.com CLI -A fast, scriptable command-line client for the [Capital.com](https://capital.com) Open API, built with Typer and Rich. +An **unofficial**, fast, scriptable command-line client for the [Capital.com](https://capital.com) Open API, built with Typer and Rich. Independent project — not affiliated with or endorsed by Capital.com. Browse markets, manage accounts and watchlists, preview and execute trades behind multiple safety guardrails, and stream real-time prices — from your terminal, in human-readable tables or raw JSON for automation. diff --git a/capital_cli/cli/app.py b/capital_cli/cli/app.py index c88197b..02e24b1 100644 --- a/capital_cli/cli/app.py +++ b/capital_cli/cli/app.py @@ -23,7 +23,7 @@ app = typer.Typer( no_args_is_help=True, add_completion=True, - help="capctl — command-line client for the Capital.com Open API.", + help="capctl — unofficial command-line client for the Capital.com Open API (not affiliated with Capital.com).", epilog=( "Getting started:\n" " capctl doctor # check env, credentials, and trading status\n" diff --git a/docs/CLI.md b/docs/CLI.md index 074df65..bcf4c95 100644 --- a/docs/CLI.md +++ b/docs/CLI.md @@ -1,6 +1,6 @@ # `capctl` -capctl — command-line client for the Capital.com Open API. +capctl — unofficial command-line client for the Capital.com Open API (not affiliated with Capital.com). **Usage**: diff --git a/pyproject.toml b/pyproject.toml index 48eff98..d06c100 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,7 +1,7 @@ [project] name = "capitalcom-cli" dynamic = ["version"] -description = "Command-line client for the Capital.com Open API" +description = "Unofficial command-line client for the Capital.com Open API" authors = [{name = "Simon Tarara"}] readme = "README.md" requires-python = ">=3.10" From 2c20fe3f7d5bc5cd37bd16178af811793ff4f79a Mon Sep 17 00:00:00 2001 From: SimonTarara62 <33222802+SimonTarara62@users.noreply.github.com> Date: Mon, 15 Jun 2026 19:15:54 +0300 Subject: [PATCH 3/3] release: v0.6.1 Explicit unofficial positioning; awesome-list submission tracker. Co-Authored-By: Claude Opus 4.8 --- CHANGELOG.md | 8 ++++++++ capital_cli/__init__.py | 2 +- 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 9dfeac8..5003533 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,14 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [Unreleased] +## [0.6.1] - 2026-06-15 + +### Changed +- Made the project's **unofficial** status explicit in the README title/tagline, + the package description (PyPI summary), the GitHub repository "About", and the + `capctl --help` text. Added `docs/awesome-submission.md` tracking curated-list + targets and their requirements. No API or behavior changes. + ## [0.6.0] - 2026-06-14 ### Added diff --git a/capital_cli/__init__.py b/capital_cli/__init__.py index cd51f69..b6a6b22 100644 --- a/capital_cli/__init__.py +++ b/capital_cli/__init__.py @@ -1,3 +1,3 @@ """Capital.com command-line client.""" -__version__ = "0.6.0" +__version__ = "0.6.1"