Agent Fleet questions and answers
If the detail you need is not here, email [email protected].
Machines and licences
How is a machine counted?
By a hash of the machine’s hardware UUID. The raw UUID never leaves the machine, and renaming the machine does not change its identity.
Does reinstalling the operating system use another slot?
No. Reinstalling the operating system or replacing a drive does not change the hardware UUID. A new motherboard or a new machine does count as a new one.
How do I free a machine slot?
Run af-ctl activate --remove on that machine. The slot becomes available for another machine.
Will Free begin charging automatically?
No. Free needs no sign-up, email address, or payment method. It is for machines connected through the same local network.
Compatibility
Which agent tools work today?
Claude Code CLI and Codex CLI. See the compatibility guide for the current operating systems and architectures.
How complete is Windows support?
Windows is a first-class target with x64 and ARM64 builds. Windows 10 version 1809 is the minimum supported release.
Is Linux supported?
Yes, on x64 systems. Agent Fleet requires a working systemd user session; Ubuntu 24.04 LTS is the verified target. The requirement is the service environment, not an Ubuntu-only allowlist. Containers without a systemd user session are not supported.
How large a file can I send?
Up to 1 GB between machines on your own network. Through the cloud relay the limit is 100 MB.
Messages and privacy
Can Woodor read my messages?
No. Message content is encrypted on the sending machine, and Woodor does not hold the key. A Plus relay can see the delivery envelope it needs: sender, recipient, time, and message size. See the privacy policy for the complete boundary.
Does the client collect telemetry?
No. Agent Fleet does not send product telemetry.
What contacts the internet on Free?
The download service is used to install Agent Fleet and check for updates. Messages stay on your local network; Free does not use the licence server or cloud message relay.
Can a message wait for an offline machine?
Yes. The local server queues local messages. On Plus, the encrypted cloud relay can also hold a cross-network message until the destination reconnects.
Installing and removing
What does the installer add?
It installs am for messages and files, af-ctl for machine administration, the imclaude and imcodex session launchers, and supporting user-level services. It then adds the binary directory to your shell path.
Does Agent Fleet open a port?
The local message-server machine listens on TCP 26800 and announces itself over mDNS. Client machines only connect out and do not open an inbound port.
How do I remove Agent Fleet?
Run af-ctl uninstall to remove services and integrations. Add --purge to also remove messages, settings, and logs. See troubleshooting for the full note.