antonio-cli
A command-line tool for managing your Discord server remotely — ban, kick, and send messages from your terminal, authenticated with a per-server API key.
Installation
pip install antonio-cli
Setup
Before using the CLI, generate an API key for your server by running a.api create in Discord. The key will be sent to you via DM — save it, it won't be shown again.
Then configure the CLI:
antonio configure
You'll be asked for:
- Your API key
- Your server (guild) ID
- The base URL for the API (has a default — just press enter if you're not sure)
This is a one-time setup per machine. The first request from a new device requires approval from the key owner (they'll get a DM with instructions) — after that, the device is trusted.
Usage
Look up a user's ID by username:
antonio lookup --user someuser
Ban a user:
antonio ban --user someuser --reason "spamming"
Kick a user:
antonio kick --user someuser --reason "rule violation"
You can also skip the username lookup if you already have the user's ID:
antonio ban --user-id 123456789012345678 --reason "spamming"
Send a message to a channel:
antonio msg --channel 111222333444555 --text "hello from the CLI"
Notes
- Each API key is scoped to a single server — a key generated for one server cannot be used against another.
- If a command returns a "waiting for approval" message, ask whoever holds the key to approve your device before retrying.
- Config is stored locally at
~/.antonio/config.jsonwith restricted file permissions.
Requirements
- Python 3.9+
- A valid API key generated by the bot for the server you want to manage
License
MIT
Metadata
Release files for antonio-cli 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| antonio_cli-0.1.0.tar.gz | 3.8 kB | Without provenance | Details for antonio_cli-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| antonio_cli-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for antonio_cli-0.1.0-py3-none-any.whl |
Total release size: 8.2 kB
Release files / antonio_cli-0.1.0.tar.gz
| Download URL | antonio_cli-0.1.0.tar.gz |
|---|---|
| Size | 3.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
30a17a2dc8549386ccf552a3129000dd0c49e5ad57877f44b44a968b4aa04dd7
|
|
BLAKE2b-256 checksum How to use checksums |
03f73fe3017212b647966771c015e2ba48ec9d8e004381719855077cf37a4101
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.14
|
Release files / antonio_cli-0.1.0-py3-none-any.whl
| Download URL | antonio_cli-0.1.0-py3-none-any.whl |
|---|---|
| Size | 4.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
6c543d1baa56998d94e4f69e1c2f333ec42f4085235e6b10bb1620b084b3195b
|
|
BLAKE2b-256 checksum How to use checksums |
bcc77cb5fcaf2a006276b94344a084faadf24c59f3104d710d7fbc361026599b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.11.14
|
Security for antonio-cli 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.