Skip to main content
Arakun runs Droid through Factory’s droid CLI, in its own JSON-RPC mode. No adapter or Node.js is needed.

What you need

The droid CLI, from factory.ai. Arakun looks for it on your PATH and in ~/.local/bin. Set ARAKUN_DROID_BIN to use another binary.

Sign in

Run droid in a terminal and sign in, or press Ctrl+K and pick Sign in to Droid, which opens a terminal that runs it. You don’t need a project open. Sessions use droid’s own login. When it expires, droid renews it itself. To sign out, sign out on Factory’s side.

See your plan

Settings › Droid › Plan usage opens the Factory account dialog. Arakun reads your plan’s limits with droid’s login, FACTORY_API_KEY, or a Factory API key you connect there:
1

Create a key

In Factory, open Settings › API Keys and create one.
2

Connect it

Paste the key in the dialog and click Connect. Arakun keeps it in the system keyring and only uses it to read usage. It sends it only to api.factory.ai.

Pick a model

The menu next to the composer lists the models droid offers, with each one’s credit multiplier, such as ×2. Models your plan can’t use show why. Each model has its own reasoning levels. Two more settings sit there:
  • Autonomy: what Droid may do without asking. Ask first reads freely and asks before any edit or command. Low edits files. Medium also runs reversible commands, like installs and builds. High runs any command, pushes and deploys included.
  • Mode: Normal works on the task straight away. Spec writes a plan first and waits for your approval.
A new session starts with the defaults in sessionDefaultSettings in ~/.factory/settings.json.

Usage

The Usage tab reads token use and Factory credits from Droid’s own logs in ~/.factory/sessions. With your plan connected, it shows the 5-hour, weekly and monthly windows of the pool you use, Standard or Core, and any extra usage balance. The session footer shows tokens, credits and how full the context is. Arakun sends a desktop notification at 80% and when a limit is reached.

Good to know

  • Settings › Droid › Extensions turns skills and MCP servers on or off for the environment on screen.
  • Droid can name new branches after the task. See Start a session.
  • With Sandbox agents on in Settings › Project, Droid runs in a sandbox.

What does not work yet

  • No fast mode.
  • arakun agent new can’t start a Droid session, and headless agents can’t run Droid.
  • Arakun doesn’t change your overage setting. When your Standard usage runs out, pick Droid Core or Extra Usage in Factory.

Common errors

Install Factory’s CLI, or point ARAKUN_DROID_BIN at the binary.
Click Sign in in a terminal under the error, or run droid in a terminal and sign in. Then retry.
Your plan has no room left for this model. Pick a cheaper model, switch to Droid Core or Extra Usage in Factory, or use Claude Code: the composer offers the switch.
The key in the Factory account dialog no longer works. Create a new one and connect it, or click Disconnect to read limits with droid’s login.