KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #claude-code #codex #developer-tools #dsh-plugin #deepseek-harness #windows #open-source #agent-skills #ai

droid-factory

★ 82 Open GitHub ↗

Install custom Factory Droid subagents and delegate work using custom slash commands.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Droid Factory install

Install custom Factory Droid subagents and delegate work using custom slash commands with a single `npx droid-factory` (or `bunx droid-factory`) call. By default it launches a guided, step‑by‑step installer where you pick the install location (personal or project) and choose which commands and droids to install; flags are available for non‑interactive “install everything” runs.

## Usage

```bash
npx droid-factory
```
```bash
bunx droid-factory
```

The guided flow highlights existing files, lets you decide on overwrites, and ends with a concise summary.

Ensure **Custom Droids** are enabled in Factory (`/settings` → Experimental → Custom Droids) or by adding `"enableCustomDroids": true` to `~/.factory/settings.json`; otherwise the installed commands cannot launch their helper agents.

### Guided flow

- Step 1/6 — Choose install location (Personal `~/.factory` or Project `./.factory`)
- Step 2/6 — Choose source (Templates or Marketplace)

Templates (bundled):
- Step 3/6 — Install all commands and droids?
- Step 4/6 — Select commands to install
- Step 5/6 — Select droids to install
- Step 6/6 — Overwrite existing files if found?
- Summary shows what was created/overwritten/skipped and next steps

Marketplace:
- Step 3/6 — Enter marketplace (path/url/owner/repo)
- Step 4/6 — Install all plugins?
- Step 5/6 — Select plugins to install
- Step 6/6 — Overwrite existing files if found?
- Summary shows what was created/overwritten/skipped and next steps

### Optional flags (non-interactive)

- `--yes` — run without interactive confirmations
- `--dry-run` — preview actions and summary without writing files
- `--scope personal|project` and `--path <repo-root>` — target install location
- `--commands all|name1,name2` and `--droids all|name1,name2` — select what to install
- `--only-commands`, `--only-droids` — limit to one type
- `--force` — overwrite existing files
- `--list` — list available templates
- `--verbose` — print the detailed plan
- Marketplace: `--marketplace <path|url|owner/repo>`, `--plugins all|name1,name2`, `--import marketplace|templates`, `--ref <branch-or-tag>`, `--debug`

## Contributing commands or droids

1. Fork this repository.
2. Add or modify Markdown templates in `templates/commands/` or `templates/droids/`.
3. Run `npm test` or `npm run lint` if scripts are provided (future roadmap).
4. Verify your changes locally (see "Local development" below).
5. Commit with clear messages and open a pull request against the main branch.
6. Include before/after installer output as needed to demonstrate your change.

## Local development

```bash
git clone https://github.com/iannuttall/droid-factory.git
cd droid-factory
npm install

node bin/droid-factory.js --dry-run --yes
node bin/droid-factory.js --yes
```

Use `npm pack` to sanity-check the tarball before publishing, and remember to bump `package.json` versions per semantic versioning guidelines.

droid-factory

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README