Command line reference

ixel is IXEL One’s command. It is the same program on Linux, macOS and Windows. Run ixel --help, or ixel <command> --help, for the same list.

Commands

Command	What it does
ixel	In a terminal: your agents (the same as ixel chat)
ixel up	Sign in if needed, and connect this computer to your devices
ixel down	Disconnect (stay signed in)
ixel devices	This computer and your others
ixel whoami	Who this computer is signed in as
ixel logout	Remove this computer from your devices and sign out of IXEL
ixel chat	Your agents in the terminal: every computer’s chats, to watch, approve and continue
ixel -p "…"	One prompt to your agents, with no window. See Scripts and CI
ixel update	Update IXEL One to the newest release
ixel service	Run the background service
ixel service install	Start the service with your login (or the computer)
ixel service uninstall	Stop starting the service with your login (or the computer)

ixel up

Flag	What it does
--name <name>	This computer’s name (default: its hostname)
--socks5 <address>	The local SOCKS5 proxy to your devices (default 127.0.0.1:1055; empty turns it off)
--expose <ports>	Ports your other devices may reach while this runs, like 22,8080,53/udp
--expose-all <true|false>	Let your devices reach every port on this computer (saved)
--port <port>	UDP port for WireGuard (default 41641; any free one when it is taken)

ixel update

Flag	What it does
--check	Only say whether there’s a newer release

ixel service install and uninstall

Flag	What it does
--system	For the whole computer, even when nobody signs in (needs administrator rights)
--managed	Configured only from your other devices or app.ixel.ai (install only)
--state <folder>	Where the device keeps its key and settings (install only)
--print	Show what would be installed, and change nothing

Flags for every command

up, down, devices, whoami, logout, chat and service also take:

Flag	What it does
--managed	A computer without a screen: configured only from your other devices or app.ixel.ai
--state <folder>	Where this computer keeps its device key and settings (default: the shared IXEL folder)
-v, --verbose	Log more
--server <url>	Another coordination server (or IXEL_MESH_SERVER)
--auth <url>	Another IXEL Auth (or IXEL_AUTH)

ixel service also takes --exit-when-idle <time>, like 30s: stop once no app has needed it for that long.