Command line
`ant0` drives the same background service as the desktop app: profiles, proxies, extensions, cookies and the event stream from a terminal or a script.
Updated Sep 7, 2026
Where the command comes from
Not in the current installers. The
ant0 command line exists and is
tested, but version 0.1.4 ships the desktop app alone; the command will be included in a later
release. Until then every operation below is available through the local API
(the app's Automation screen shows the address and token), and the reference is published so
scripts can be prepared.
ant0 talks to the same local background service as the desktop app, so the app (or
ant0 daemon start) has to be running. Output is a table by default; --json
prints the API payload verbatim for scripts. Profiles and proxies can be addressed by id or by
their exact name.
Connecting to the background service
ant0 finds the service through the data folder: it reads ant0d.pid for
the port and ant0d.token for the bearer token. Override the folder with
--home (or ANT0_HOME) and the port with --port
(or ANT0D_PORT). The same token authenticates calls to the
local API.
Examples
ant0 profiles ls --json | jq '.[] | select(.status == "running") | .name'
ant0 profiles create "Shop DE" --group Shops --tag eu --proxy "http://user:pass@host:8000"
ant0 profiles start "Shop DE" # prints ws://127.0.0.1:<port>/devtools/browser/… for Playwright or Puppeteer
ant0 profiles cookies export "Shop DE" --format netscape -o shop-de.txt
ant0 proxies add --name "DE 01" "host:port:user:pass" && ant0 proxies check "DE 01"
ant0 events --replay 20 # one JSON event per line, Ctrl-C to stopReference
As printed by ant0 <command> --help, version 0.1.4.
ant0
Usage: ant0 [options] [command]
Ant0: profile manager for Ant0 Browser (client of the local ant0d daemon)
Options:
-V, --version print the CLI version
--home <dir> data directory (default: $ANT0_HOME, else the
platform data folder)
--port <n> daemon port (default: from ant0d.pid, $ANT0D_PORT or
27100)
--json print the API payload verbatim instead of a table
-h, --help display help for command
Commands:
daemon Run and inspect the local ant0d daemon
browsers Installed Ant0 Browser releases
profiles Browser profiles
trash Profiles waiting in the trash (restore with `ant0
profiles restore`)
proxies Shared proxy objects
extensions Extension library shared by profiles (unpacked
folders under <home>/extensions)
events [options] Tail the event stream (one JSON object per line;
Ctrl-C to stop)
login [options] [email] Sign in to your Ant0 account on this computer (the
daemon holds the session)
logout Sign this computer out (the licence and cloud session
are forgotten)
account Show the account and licence state of this computer
(GET /v1/licence)
licence Licence of this computer
help [command] display help for command
ant0 --json
Usage: ant0 [options] [command]
Ant0: profile manager for Ant0 Browser (client of the local ant0d daemon)
Options:
-V, --version print the CLI version
--home <dir> data directory (default: $ANT0_HOME, else the
platform data folder)
--port <n> daemon port (default: from ant0d.pid, $ANT0D_PORT or
27100)
--json print the API payload verbatim instead of a table
-h, --help display help for command
Commands:
daemon Run and inspect the local ant0d daemon
browsers Installed Ant0 Browser releases
profiles Browser profiles
trash Profiles waiting in the trash (restore with `ant0
profiles restore`)
proxies Shared proxy objects
extensions Extension library shared by profiles (unpacked
folders under <home>/extensions)
events [options] Tail the event stream (one JSON object per line;
Ctrl-C to stop)
login [options] [email] Sign in to your Ant0 account on this computer (the
daemon holds the session)
logout Sign this computer out (the licence and cloud session
are forgotten)
account Show the account and licence state of this computer
(GET /v1/licence)
licence Licence of this computer
help [command] display help for command
ant0 --json daemon
Usage: ant0 daemon [options] [command]
Run and inspect the local ant0d daemon
Options:
-h, --help display help for command
Commands:
start [options] Start ant0d in the background (or attached with --foreground)
stop Stop the running daemon (SIGTERM, waits up to 10 s)
status Show whether the daemon answers and where
help [command] display help for command
ant0 --json browsers
Usage: ant0 browsers [options] [command]
Installed Ant0 Browser releases
Options:
-h, --help display help for command
Commands:
ls List installed releases
default <version> Make an installed release the one unpinned profiles
launch
available [options] Show the current release of a channel
install [options] Download and verify a release (the channel's current one
by default)
rm <version> Remove an installed release (refused while a profile uses
it)
help [command] display help for command
ant0 --json profiles
Usage: ant0 profiles [options] [command]
Browser profiles
Options:
-h, --help display help for command
Commands:
ls [options] List profiles
create [options] <name> Create a profile
show <id> Show a profile (UUID or exact name) and its runtime
state
edit [options] <id> Patch fields: --set
network.geo.timezone=Europe/Berlin --set tags=a,b
--set pinned=true
set [options] <ref...> Change group, tags or pin on one or more profiles
(POST /profiles/bulk-update); use `edit --set` for
any other field
rm [options] <ref...> Move profiles to the trash (kept for a few days,
`profiles restore` brings them back); --permanent
deletes them for good, data directory included.
Refused while running
restore <ref...> Bring profiles back from the trash
start [options] <ref...> Launch the browser for a profile and print its CDP
endpoint; several refs start in sequence (POST
/profiles/bulk-start)
stop [options] <ref...> Stop the running browser of one or more profiles
(POST /profiles/bulk-stop)
status <id> Run state and live session of a profile
identity <id> Preview the fingerprint persona the profile will
launch with
cookies Import and export cookies
bulk <file> Create profiles from a CSV file (header row + one
profile per row)
help [command] display help for command
ant0 --json trash
Usage: ant0 trash [options] [command]
Profiles waiting in the trash (restore with `ant0 profiles restore`)
Options:
-h, --help display help for command
Commands:
ls [options] List trashed profiles and when each will be purged
empty [options] Permanently delete every trashed profile now (running ones
are skipped)
help [command] display help for command
ant0 --json proxies
Usage: ant0 proxies [options] [command]
Shared proxy objects
Options:
-h, --help display help for command
Commands:
ls [options] List proxies
add [options] <proxy> Add a proxy from scheme://user:pass@host:port or
host:port:user:pass
show <ref> Show one proxy (UUID or exact name)
check <ref> Connect through the proxy and report exit IP, country
and latency
change-ip <ref> Ask the provider for a new exit IP (GETs the proxy's
change_ip_url)
rm <ref> Delete a proxy (refused while a profile references it)
help [command] display help for command
ant0 --json extensions
Usage: ant0 extensions [options] [command]
Extension library shared by profiles (unpacked folders under <home>/extensions)
Options:
-h, --help display help for command
Commands:
ls List library extensions and how many profiles use each
add <path> Add an unpacked extension folder, a .zip or a .crx to the
library
show <id> Show one library extension
rm [options] <id> Remove an extension from the library (refused while a
profile uses it)
help [command] display help for command
ant0 --json licence
Usage: ant0 licence [options] [command]
Licence of this computer
Options:
-h, --help display help for command
Commands:
refresh Ask the Ant0 cloud for a fresh licence now (otherwise hourly)
help [command] display help for command
ant0 daemon
Usage: ant0 daemon [options] [command]
Run and inspect the local ant0d daemon
Options:
-h, --help display help for command
Commands:
start [options] Start ant0d in the background (or attached with --foreground)
stop Stop the running daemon (SIGTERM, waits up to 10 s)
status Show whether the daemon answers and where
help [command] display help for command
ant0 browsers
Usage: ant0 browsers [options] [command]
Installed Ant0 Browser releases
Options:
-h, --help display help for command
Commands:
ls List installed releases
default <version> Make an installed release the one unpinned profiles
launch
available [options] Show the current release of a channel
install [options] Download and verify a release (the channel's current one
by default)
rm <version> Remove an installed release (refused while a profile uses
it)
help [command] display help for command
ant0 profiles
Usage: ant0 profiles [options] [command]
Browser profiles
Options:
-h, --help display help for command
Commands:
ls [options] List profiles
create [options] <name> Create a profile
show <id> Show a profile (UUID or exact name) and its runtime
state
edit [options] <id> Patch fields: --set
network.geo.timezone=Europe/Berlin --set tags=a,b
--set pinned=true
set [options] <ref...> Change group, tags or pin on one or more profiles
(POST /profiles/bulk-update); use `edit --set` for
any other field
rm [options] <ref...> Move profiles to the trash (kept for a few days,
`profiles restore` brings them back); --permanent
deletes them for good, data directory included.
Refused while running
restore <ref...> Bring profiles back from the trash
start [options] <ref...> Launch the browser for a profile and print its CDP
endpoint; several refs start in sequence (POST
/profiles/bulk-start)
stop [options] <ref...> Stop the running browser of one or more profiles
(POST /profiles/bulk-stop)
status <id> Run state and live session of a profile
identity <id> Preview the fingerprint persona the profile will
launch with
cookies Import and export cookies
bulk <file> Create profiles from a CSV file (header row + one
profile per row)
help [command] display help for command
ant0 profiles cookies
Usage: ant0 profiles cookies [options] [command]
Import and export cookies
Options:
-h, --help display help for command
Commands:
import <id> <file> Import cookies (Cookie-Editor JSON,
Puppeteer/Playwright arrays, or Netscape cookies.txt)
export [options] <id> Export cookies
help [command] display help for command
ant0 trash
Usage: ant0 trash [options] [command]
Profiles waiting in the trash (restore with `ant0 profiles restore`)
Options:
-h, --help display help for command
Commands:
ls [options] List trashed profiles and when each will be purged
empty [options] Permanently delete every trashed profile now (running ones
are skipped)
help [command] display help for command
ant0 proxies
Usage: ant0 proxies [options] [command]
Shared proxy objects
Options:
-h, --help display help for command
Commands:
ls [options] List proxies
add [options] <proxy> Add a proxy from scheme://user:pass@host:port or
host:port:user:pass
show <ref> Show one proxy (UUID or exact name)
check <ref> Connect through the proxy and report exit IP, country
and latency
change-ip <ref> Ask the provider for a new exit IP (GETs the proxy's
change_ip_url)
rm <ref> Delete a proxy (refused while a profile references it)
help [command] display help for command
ant0 extensions
Usage: ant0 extensions [options] [command]
Extension library shared by profiles (unpacked folders under <home>/extensions)
Options:
-h, --help display help for command
Commands:
ls List library extensions and how many profiles use each
add <path> Add an unpacked extension folder, a .zip or a .crx to the
library
show <id> Show one library extension
rm [options] <id> Remove an extension from the library (refused while a
profile uses it)
help [command] display help for command
ant0 events
Usage: ant0 events [options]
Tail the event stream (one JSON object per line; Ctrl-C to stop)
Options:
--since <iso-date> replay buffered events at or after this time
--replay <n> how many buffered events to replay first (default 50)
-h, --help display help for command
ant0 login
Usage: ant0 login [options] [email]
Sign in to your Ant0 account on this computer (the daemon holds the session)
Arguments:
email account email (asked for on a terminal when omitted)
Options:
--totp <code> 6-digit authenticator code or a recovery code (2FA accounts)
--password-stdin read the password from stdin instead of the terminal
-h, --help display help for command
ant0 logout
Usage: ant0 logout [options]
Sign this computer out (the licence and cloud session are forgotten)
Options:
-h, --help display help for command
ant0 account
Usage: ant0 account [options]
Show the account and licence state of this computer (GET /v1/licence)
Options:
-h, --help display help for command
ant0 licence
Usage: ant0 licence [options] [command]
Licence of this computer
Options:
-h, --help display help for command
Commands:
refresh Ask the Ant0 cloud for a fresh licence now (otherwise hourly)
help [command] display help for command