Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.entire.io/llms.txt

Use this file to discover all available pages before exploring further.

Droid is Factory’s AI-powered development agent. Entire integrates with Droid via its hook-based settings system, automatically capturing sessions and checkpoints. The Droid integration is in preview and may contain bugs.

​
Prerequisites

​
Enable

entire agent add factoryai-droid
droid
entire agent add factoryai-droid installs hooks into .factory/settings.json automatically.
The hooks track the full session lifecycle:
  1. Session Start — fires when Droid launches, creating a new Entire session.
  2. Turn Tracking — each user prompt triggers tracking via user-prompt-submit hooks.
  3. Subagent Tracking — pre-tool-use and post-tool-use hooks capture Task tool invocations for nested session support.
  4. Session End — fires when Droid exits, finalizing the session.
  5. Transcript Capture — session transcript is read from Droid’s JSONL log files.
  6. Session Storage — data saved to the entire/checkpoints/v1 branch.
DataDescription
ConversationFull transcript of prompts and responses
File changesAll files modified during the session
Tool callsTool invocations with inputs and outputs
Token usageInput, output, reasoning, and cache tokens
TimestampsSession, message, and checkpoint timing
Nested session support. When Droid spawns sub-agents via the Task tool, Entire captures these as nested sessions through pre-tool-use and post-tool-use hooks:
Main Session
├── Checkpoint 1
├── Sub-agent Session (Task: "Run tests")
│   ├── Sub-checkpoint 1
│   └── Sub-checkpoint 2
└── Checkpoint 2
Nested sessions preserve the full context of complex multi-agent workflows.Rewind during sessions. Use entire checkpoint rewind to restore to a previous checkpoint during or after a Droid session. See the rewind command reference for full flag documentation.Resume previous sessions. Switch to a session’s branch with entire session resume <branch>. The CLI restores the session log if needed and prints droid --session-id <id>. See the resume command reference for full flag documentation.Explain commits. Inspect any commit or checkpoint with entire checkpoint explain. See the explain command reference for full flag documentation.
  • The integration is in preview and may have rough edges.
  • Session detection relies on hook-based process detection.
  • Transcript capture depends on Droid writing JSONL session logs.
Commit at logical points. Commit when you’ve made meaningful progress:
git add .
git commit -m "Implement feature with Droid assistance"
Check status regularly. Monitor your session with entire status.
# 1. Enable Entire with Factory Droid
cd my-project
entire agent add factoryai-droid

# 2. Start Droid
droid

# 3. Work with Droid
# Ask it to write code, make changes, etc.

# 4. Check session (in another terminal)
entire status

# 5. Rewind if needed
entire checkpoint rewind

# 6. Commit when ready
git add .
git commit -m "Add feature with Droid"

# 7. Push to see on entire.io
git push
Your session is now visible on entire.io with full context for code review.

​
Troubleshooting

  1. Ensure you’re in an Entire-enabled repo: entire status
  2. Verify Droid is running from within the repository
  3. Check that hooks are installed in .factory/settings.json
  4. Check Git hooks are installed: ls .git/hooks
  1. Checkpoints require file changes — ensure Droid is modifying files
  2. Check your settings in .entire/settings.json
  3. Verify the .factory/settings.json hooks are present
  1. Ensure Droid’s session storage exists at ~/.factory/sessions/<repo>/
  2. Check that JSONL transcript files are being written
  3. Look for errors in the Entire hook output