idx

daemon

Purpose

Manage background watch processes for one or more projects.

Usage

idx daemon <subcommand>
idx daemon enable <path>
idx daemon disable <path>
idx daemon status

Arguments

• enable <path>: requires exactly one path argument.
• disable <path>: requires exactly one path argument.
• status: no positional arguments.

Flags

• Global: --quiet, -q.

Behavior and Side Effects

• enable:
  • Resolves project path to absolute path and validates it exists.
  • Checks daemon state to avoid duplicate monitoring.
  • If already monitored with a live process, returns success without extra output (idempotent).
  • If index is missing, auto-runs init from target path.
  • Spawns background watch process and stores PID/state.
• disable:
  • Resolves absolute path.
  • Stops tracked process by PID when available.
  • Removes project from daemon state.
• status:
  • Prints monitored project list with running/stopped indication.

Output

• enable success:
  • ✅ Watch enabled for "<abs-path>"
  • 👀 Monitoring in realtime (PID: <pid>)
• enable when index is missing:
  • ℹ️ Index not found. Creating initial index...
• disable success:
  • ✅ Watch disabled for "<abs-path>"
• status with no projects:
  • ❌ No projects being monitored
• status with projects:
  • Header: 📊 Monitored Projects:
  • One line per project with status, path, PID, start time.

Errors

• CLI argument contract:
  • expected project path argument (wrong arg count for enable/disable)
• enable path validation failures.
• Failure to start watch process.
• Failure to persist daemon state.
• disable when daemon state is empty or project not registered.

Examples

idx daemon enable .
idx daemon status
idx daemon disable .

This site is open source. Improve this page.