Factory Droid

Factory Droid is a model-agnostic, terminal-native autonomous AI coding agent. Capture your sessions with SpecStory and keep your prompts and reasoning intact as Markdown in your repo.

Run Droid CLI with SpecStory

specstory run droid

You can keep using Droid’s features like spec mode planning, skills, and slash commands like /review, etc. while SpecStory records the conversation and shell context.

Sync existing Droid CLI sessions

Forgot to launch with specstory run? Convert prior sessions with specstory sync.

# Convert everything Droid CLI has stored locally
specstory sync droid

# Export a single session by ID
specstory sync droid -s <session-uuid>

# Inspect sync logs in your terminal
specstory sync droid --console

• Session sources: Reads from ~/.factory/ (Factory Droid agent's session storage).

The resulting Markdown files live under .specstory/history/ with timestamps and metadata for easy sharing.

Watch for Droid CLI activity

Prefer to run Droid CLI directly or via another tool? Use specstory watch to watch the current project directory for any new agent activity and auto-save it to markdown.

# Watch for only activity from any supported coding agent
specstory watch

# Watch for only new Droid CLI activity
specstory watch droid

Run specstory watch without an agent name to capture activity from any supported provider.

Best Practices

• Start a fresh session or clear context when you move from planning to implementation to review.
• Add an AGENTS.md in your repo and ask Droid to read it before changes so SpecStory captures the shared context.
• Use spec mode planning, then implement and finish with /review so the captured Markdown includes decisions and validation.
• Use specialized skills for discrete tasks and keep their outputs in the transcript for review.
• Document and archive Droid histories alongside code.

Troubleshooting

• droid command missing: Run droid --version outside SpecStory to verify installing Factory Droid CLI.
• No Markdown output: Make sure you start specstory run droid inside a writable project folder.
• specstory sync finds nothing: Droid CLI must have an existing session database in the current directory.
• Need assistance? Contact support@specstory.com or open a ticket on GitHub.