Home Client

The MIFY Home Client runs AI coding agents locally on your machine with human review gates — no cloud connectivity required.

What It Does

The Home Client coordinates two AI agents in a loop:

1. Agent 1 (e.g., Claude Code) — implements your task
2. Agent 2 (e.g., Codex) — reviews the changes
3. You — approve, reject, or request changes at the human review gate

You give a task
  → Agent 1 implements it
    → System captures the git diff
      → Agent 2 reviews the diff
        → You decide: Approve or Request Changes
          → If approved: Done
          → If changes requested: Agent 1 iterates

Getting Started

Prerequisites

• Node.js 22+
• Git installed
• Claude Code CLI or Codex CLI installed

Starting the Runtime

1. Set MIFY_PROFILE=home in your environment
2. Run the start script:

   ./scripts/start-home-runtime.ps1   # Windows PowerShell

3. Open http://localhost:3006 in your browser

Starting a Run

1. Navigate to the Home section in the UI
2. Click New Run
3. Configure:
   • Repository: Path to the git repo you want to work in
   • Task: Describe what you want done
   • Max Iterations: How many feedback loops (default: 3)
4. Click Start

Agent Run Modes

Mode	Behavior
Human	Interactive terminal — you can watch and send input
Auto	Non-interactive — agent runs autonomously

Scheduled Runs

Automate recurring tasks with the cron scheduler:

1. Create a schedule with a cron expression and task prompt
2. The scheduler runs the agent loop at the specified times
3. View results at /api/home/schedules/results/recent

Schedules support timezone configuration and can be enabled/disabled independently.

Workspace Modes

Mode	How It Works
Repo (default)	Creates a git worktree — changes are isolated from your main branch
Temp	Creates a temporary directory — no git, good for experiments

Configuration

Agent configuration is stored in ~/.mify/config.json:

{
  "agents": [
    { "id": "claude-code", "name": "Claude Code CLI", "command": "claude" },
    { "id": "codex", "name": "OpenAI Codex CLI", "command": "codex" }
  ],
  "defaultAgent1": "claude-code",
  "defaultAgent2": "codex",
  "maxIterations": 3
}

Artifacts

Each run stores artifacts locally at ~/.mify/runs/<runId>/:

• checkpoints/ — state snapshots for resuming
• events/ — state transition log
• diffs/ — git diffs per iteration
• transcripts/ — agent terminal output

Runs are retained for 30 days (max 100 runs).

Cloud Sync (Optional)

Optionally sync run summaries and artifacts to the MIFY cloud for backup and cross-device access.