Droid Model Tuner (JS)

A TUI (Terminal User Interface) tool for managing Factory droid/subagent model configurations. Built with Ink (React for CLIs).

Features

• View all your Factory droids and their current model assignments
• Change models for individual droids or all at once
• Reasoning effort picker that only shows valid levels for the selected model (plus “use model default”)
• Supports official Factory models + your custom BYOK models
• Visual indicators for unsaved changes
• Vim-style navigation (j/k keys)

Installation

Quick Run (no install needed)

npx droid-model-tuner

Install Globally

npm install -g droid-model-tuner

Usage

droid-model-tuner

Keybindings

| Key | Action | |-----|--------| | j / ↓ | Move down | | k / ↑ | Move up | | Enter | Edit selected droid's model | | a | Set ALL droids to a model | | i | Set ALL droids to "inherit" (clears reasoningEffort) | | s | Save changes | | r | Reload from disk | | q | Quit |

How It Works

The tool reads droid configurations from:

• Personal droids: ~/.factory/droids/*.md

It also reads your BYOK custom models from ~/.factory/settings.json (customModels) to include them in the model picker.

License

MIT