Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -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.

Expand Down
2 changes: 1 addition & 1 deletion capital_cli/__init__.py
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
"""Capital.com command-line client."""

__version__ = "0.6.0"
__version__ = "0.6.1"
2 changes: 1 addition & 1 deletion capital_cli/cli/app.py
Original file line number Diff line number Diff line change
Expand Up @@ -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"
Expand Down
2 changes: 1 addition & 1 deletion docs/CLI.md
Original file line number Diff line number Diff line change
@@ -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**:

Expand Down
38 changes: 38 additions & 0 deletions docs/awesome-submission.md
Original file line number Diff line number Diff line change
@@ -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.
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
@@ -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"
Expand Down
Loading