@orderful/droid

"Droid, teaching your AI new tricks"

AI workflow toolkit for sharing tools, commands, and agents across the engineering team.

Why Droid?

• Lower the barrier to entry - Get started with AI coding tools (Claude Code, OpenCode) without configuring from scratch
• Share what works - Power users discover great workflows, everyone benefits
• Consistent experience - Common patterns like @droid/@user comments work the same across the team

Quick Start

npm install -g @orderful/droid
droid

That's it. The TUI guides you through setup and tool installation.

Note for nodenv/nvm/asdf users: After global install, run nodenv rehash (or equivalent) to update your shims.

The TUI

Run droid to launch the interactive dashboard:

┌─────────────────────────────────────────┐
│  @orderful/droid                        │
│  "Droid, teaching your AI new tricks"   │
├─────────────────────────────────────────┤
│  > Tools      Browse and install tools  │
│    Settings   View/edit configuration   │
└─────────────────────────────────────────┘

Browse available tools, see what's installed, and manage everything from one place.

Available Tools

| Tool | Description | Status | |------|-------------|--------| | comments | Inline @droid/@user conversations in any file | beta | | project | Persistent project context across sessions | beta | | brain | Collaborative scratch pad for planning & research | beta | | code-review | Multi-agent code review with specialized checkers | alpha |

Comments

Leave notes for your AI with @droid, get responses addressed to you:

> @droid Should we cache this query?

> @fry Yes, add Redis caching. The query runs on every request.

Project

Maintain context across sessions for long-running work:

/project myfeature      # Load project context
/project update         # Capture new learnings
/project create auth    # Start a new project

Brain

Collaborative thinking space for planning and research:

/brain plan auth refactor   # Create planning doc
/brain research caching     # Research doc
/brain check                # Check for @mentions

Code Review

Run comprehensive reviews with specialized agents:

/code-review #123           # Review a PR
/code-review staged         # Review staged changes
/code-review path/to/file   # Review specific file

Configuration

Config lives in ~/.droid/:

~/.droid/
├── config.yaml                    # Global config
└── tools/
    └── {tool}/
        └── overrides.yaml         # Per-tool overrides

Tools install to your AI platform's location:

• Claude Code: ~/.claude/skills/, ~/.claude/commands/, ~/.claude/agents/
• OpenCode: ~/.config/opencode/skills/, ~/.config/opencode/commands/

CLI Reference

While the TUI is the primary interface, direct commands are available:

| Command | Description | |---------|-------------| | droid | Launch TUI dashboard | | droid setup | Run setup wizard | | droid install <tool> | Install a tool | | droid uninstall <tool> | Remove a tool | | droid update | Update droid and tools | | droid config | View/edit config |

Development

git clone https://github.com/orderful/droid.git
cd droid && bun install
bun run build
bun dist/bin/droid.js

# to test
bun link
bun unlink 

Adding Tools

1. Create src/tools/{name}/TOOL.yaml (manifest)
2. Add skills in src/tools/{name}/skills/{skill}/SKILL.yaml and SKILL.md
3. Add commands in src/tools/{name}/commands/*.md
4. Add agents in src/tools/{name}/agents/{agent}/AGENT.yaml and AGENT.md
5. Submit a PR

License

MIT