Skip to content

Conversation

@enoreyes
Copy link
Contributor

@enoreyes enoreyes commented Feb 1, 2026

Summary

Add comprehensive reference documentation for factoryd, the background daemon that orchestrates droid sessions and terminals.

Changes

  • New file: docs/reference/daemon-reference.mdx
  • Updated: docs/docs.json to include daemon reference in navigation

Documentation Covers

  • Quick start guide for developers
  • CLI usage and options
  • Environment variables
  • HTTP health endpoints
  • WebSocket JSON-RPC 2.0 API reference:
    • Session methods (initialize, load, message, interrupt)
    • Terminal methods (create, write, resize, close)
    • MCP methods (config, servers, tools, auth)
    • File and settings methods
    • Server-to-client events
  • SSH tunneling protocol
  • Session timeouts
  • Building custom integrations (with code example)
  • Troubleshooting guide

Styling

Uses Mintlify components consistent with other docs:

  • <Tip>, <Note>, <Warning> callouts
  • <CardGroup> for feature highlights
  • <CodeGroup> for command examples
  • <Steps> for sequential processes

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>

Add comprehensive documentation for factoryd daemon including:
- CLI options and environment variables
- HTTP health endpoints
- WebSocket JSON-RPC 2.0 API reference
- Session, terminal, MCP, and file methods
- SSH tunneling protocol
- Architecture overview
- Integration examples and troubleshooting

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
Copy link
Contributor

@factory-droid factory-droid bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changes look correct; no high-severity issues found in the added daemon reference doc or nav update.

@enoreyes enoreyes closed this Feb 1, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants