Henry OS

Henry OS — AI Chief of Staff Framework

> Stop being the bottleneck in your own business.

Henry OS transforms OpenClaw into a fully autonomous business partner that runs 24/7 — finding opportunities, managing your pipeline, handling communications, and executing tasks while you focus on high-leverage work.

---

What Henry OS Does

🎯 Proactive Intelligence

Henry doesn't wait for instructions. He continuously monitors your inboxes, calendars, job boards, and social channels — surfacing opportunities and flagging what needs attention before you even know it exists.

💰 Revenue Pipeline Automation

Opportunity Hunting: Scans Upwork, LinkedIn, Reddit, Indie Hackers, and niche communities for freelance/consulting leads matching your skills

Lead Scoring: Rates opportunities by fit, effort, and revenue potential

Outreach Prep: Drafts personalized proposals and messages ready for your approval

Pipeline Management: Tracks every lead from discovery to close in Mission Control

📧 Communications Management

Inbox Triage: Reads and categorizes emails by urgency (Action Needed / FYI / Noise)

Draft Replies: Prepares responses to common requests, waiting for your one-tap approval

Follow-up Automation: Never drops the ball on pending conversations

Cross-Channel: Works across Mail.app, Gmail, iMessage, SMS, WhatsApp

📅 Calendar & Life Ops

Daily Briefings: Morning agenda with priorities, meetings, and action items

Smart Scheduling: Blocks focus time around deep work, prepares for meetings

Reminders & Follow-ups: Automatically creates follow-up tasks after calls and events

Conflict Detection: Flags scheduling issues before they become problems

🛠️ Software Delivery

Client Projects: End-to-end delivery from requirements to deployment

Code Generation: Writes production-quality code in any language

Testing & QA: Validates work before presenting it to you

Documentation: Auto-generates READMEs and handoff docs

📺 YouTube Intelligence

Content Processing: Watches videos, extracts actionable insights

Implementation: Automatically applies relevant techniques to your active projects

Knowledge Base: Builds a searchable library of insights from every video you consume

---

Installation

One-Line Install

curl -fsSL https://henryos.ai/install.sh | bash

That's it. Henry OS installs in under 5 minutes and starts working immediately.

What Gets Installed

Mission Control Dashboard — Web UI at http://localhost:3333 for monitoring and management

Henry Master Agent — Your autonomous operator running 24/7

Specialist Sub-Agents — Scout, Builder, Writer, Analyst, Operator, Hunter, Watcher

Native Apple Integrations — Mail.app, Messages.app, Calendar.app, Contacts.app

Tooling Stack — All required CLIs and dependencies auto-configured

---

Quick Start

1. Launch Mission Control

After installation, open your browser to:

http://localhost:3333

This is your command center. From here you can:

View system health and agent status

Manage your task board (Kanban: Backlog / In Progress / Blocked / Done)

Browse memory and learning loops

Monitor your opportunity pipeline

Chat directly with Henry

2. Configure Your Profile

Henry needs to know about you to be effective:

# Set your core details
henry config set name "Your Name"
henry config set email "you@example.com"
henry config set timezone "Australia/Brisbane"
Define your skills (comma-separated)
henry config set skills "web development,react,node,python,automation"
Set your target rates
henry config set hourly_rate 150
henry config set project_min 2000

3. Connect Your Accounts

Henry works with your existing Apple apps — no new logins needed:

# Grant permissions (macOS will prompt)
henry setup permissions
Verify connections
henry status

4. Start Your First Hunt

# Launch the opportunity hunter
henry spawn hunter
Check what's been found
henry pipeline

5. Review Your Morning Brief

Every morning, Henry prepares a briefing:

Overnight activity summary

Today's calendar and priorities

Top 3 opportunities to pursue

Tasks requiring approval

System health check

---

Configuration Options

Core Settings

| Setting | Description | Default | |---------|-------------|---------| | name | Your name | System username | | email | Primary email | — | | timezone | Your timezone | System timezone | | skills | Comma-separated skill list | — | | hourly_rate | Target hourly rate | 100 | | project_min | Minimum project value | 1000 |

Opportunity Hunting

| Setting | Description | Default | |---------|-------------|---------| | hunt.enabled | Enable automated hunting | true | | hunt.frequency | Check interval (minutes) | 60 | | hunt.sources | Sources to monitor | upwork,linkedin,reddit | | hunt.min_budget | Minimum budget threshold | 500 |

Communications

| Setting | Description | Default | |---------|-------------|---------| | email.triage | Auto-triage emails | true | | email.drafts | Draft replies for approval | true | | messages.monitor | Monitor iMessage/SMS | true | | approval.required | Require approval for sends | true |

Notifications

| Setting | Description | Default | |---------|-------------|---------| | notify.channel | Primary notification channel | imessage | | notify.quiet_hours | Don't notify during these hours | 23:00-08:00 | | notify.urgent_only | Only notify for urgent items | false |

Advanced

# View all settings
henry config list
Edit config file directly
henry config edit
Reset to defaults
henry config reset

---

Mission Control Dashboard

The dashboard has six main sections:

1. System Health Bar

Token usage and costs

Uptime and agent count

Current status indicators

2. Task Board

Live Kanban with four columns:

Backlog — Queued work

In Progress — Active tasks

Blocked — Waiting on external input

Done — Completed work

3. Memory Viewer

Three tabs:

Episodic — Daily activity logs

Semantic — Knowledge base (contacts, tools, learnings)

Procedural — Playbooks and runbooks

4. Learning Loop Log

Last 10 learning cycles

Provisional lessons

Promote/reject actions

5. Cron Monitor

Scheduled tasks

Run history

Manual triggers

6. Approval Gate Banner

Amber full-width alert for anything needing your sign-off.

---

Sub-Agents

Henry spawns specialized agents for different work types:

| Agent | Role | When Spawned | |-------|------|--------------| | Henry-Scout | Research, scraping, monitoring | Intelligence gathering | | Henry-Builder | Coding, automation, infrastructure | Software projects | | Henry-Writer | Content, proposals, docs | Communications | | Henry-Analyst | Data synthesis, scoring, modeling | Analysis tasks | | Henry-Operator | Scheduling, inbox, reminders | Life ops | | Henry-Hunter | Opportunity ID, lead research | Revenue pipeline | | Henry-Watcher | YouTube monitoring, media intel | Content processing |

Spawn agents manually:

henry spawn hunter    # Start hunting
henry spawn builder   # Begin a build task
henry spawn analyst   # Analyze data

Check agent status:

henry agents

---

Troubleshooting

Installation Issues

Problem: Install script fails with permission error

# Solution: Run with explicit bash
bash -c "$(curl -fsSL https://henryos.ai/install.sh)"

Problem: Node version too old

# Solution: Update Node.js first
brew install node  # macOS
or
nvm install 20

Connection Issues

Problem: Mission Control won't load

# Check if server is running
henry status
Restart Mission Control
henry restart dashboard
Check logs
henry logs

Problem: Apple app permissions denied

# Re-run permission setup
henry setup permissions
Or manually grant in:
System Preferences → Security & Privacy → Privacy → Automation

Agent Issues

Problem: Agent won't spawn

# Check resource limits
henry status --resources
View agent logs
henry logs --agent henry-hunter-01

Problem: Agent stuck/running too long

# List running agents
henry agents
Terminate specific agent
henry terminate henry-hunter-01
Kill all agents and restart
henry reset agents

Opportunity Hunting

Problem: No opportunities found

Verify your skills are configured: henry config get skills

Check hunt sources: henry config get hunt.sources

Review minimum budget threshold

Try manual search: henry hunt --manual "react developer"

Problem: Too many low-quality leads

Increase minimum budget: henry config set hunt.min_budget 2000

Refine skill keywords to be more specific

Add negative keywords to exclude

Email/Communications

Problem: Not seeing emails in Mission Control

Verify Mail.app has messages in inbox

Check permissions: henry setup permissions

Force sync: henry sync email

Problem: Drafts not being created

Ensure email.drafts is enabled: henry config get email.drafts

Check approval settings aren't blocking

Getting Help

# View all commands
henry --help
Get help for specific command
henry hunt --help
Check system diagnostics
henry doctor
Export logs for support
henry logs --export

Community & Support

Documentation: https://docs.henryos.ai

GitHub Issues: https://github.com/shannonlinnan/henry-os/issues

Discord: https://discord.gg/henryos

Email: support@henryos.ai

---

Privacy & Security

Henry OS is designed with privacy-first principles:

Local-First: Your data stays on your machine

No Cloud Dependencies: Works entirely offline after installation

Apple Native: Uses macOS native APIs, no third-party bridges

Transparent: All code is open source and auditable

Approval Gates: Sensitive actions require your explicit approval

---

Roadmap

[x] Core framework and Mission Control

[x] Native Apple integrations

[x] Opportunity hunting pipeline

[x] YouTube intelligence

[ ] Windows/Linux support

[ ] Browser extension for web clipping

[ ] Mobile companion app

[ ] Team/enterprise multi-agent mode

[ ] Industry-specific agent packs

---

License

MIT License — see LICENSE for details.

---

Built with OpenClaw | Made by Shannon Linnan | henryos.ai

1. Launch Mission Control

After installation, open your browser to:

http://localhost:3333

This is your command center. From here you can:

View system health and agent status

Manage your task board (Kanban: Backlog / In Progress / Blocked / Done)

Browse memory and learning loops

Monitor your opportunity pipeline

Chat directly with Henry

2. Configure Your Profile

Henry needs to know about you to be effective:

# Set your core details
henry config set name "Your Name"
henry config set email "you@example.com"
henry config set timezone "Australia/Brisbane"
Define your skills (comma-separated)
henry config set skills "web development,react,node,python,automation"
Set your target rates
henry config set hourly_rate 150
henry config set project_min 2000

3. Connect Your Accounts

Henry works with your existing Apple apps — no new logins needed:

# Grant permissions (macOS will prompt)
henry setup permissions
Verify connections
henry status

4. Start Your First Hunt

# Launch the opportunity hunter
henry spawn hunter
Check what's been found
henry pipeline

5. Review Your Morning Brief

Every morning, Henry prepares a briefing:

Overnight activity summary

Today's calendar and priorities

Top 3 opportunities to pursue

Tasks requiring approval

System health check

---

Installation Issues

Problem: Install script fails with permission error

# Solution: Run with explicit bash
bash -c "$(curl -fsSL https://henryos.ai/install.sh)"

Problem: Node version too old

# Solution: Update Node.js first
brew install node  # macOS
or
nvm install 20

Connection Issues

Problem: Mission Control won't load

# Check if server is running
henry status
Restart Mission Control
henry restart dashboard
Check logs
henry logs

Problem: Apple app permissions denied

# Re-run permission setup
henry setup permissions
Or manually grant in:
System Preferences → Security & Privacy → Privacy → Automation

Agent Issues

Problem: Agent won't spawn

# Check resource limits
henry status --resources
View agent logs
henry logs --agent henry-hunter-01

Problem: Agent stuck/running too long

# List running agents
henry agents
Terminate specific agent
henry terminate henry-hunter-01
Kill all agents and restart
henry reset agents

Opportunity Hunting

Problem: No opportunities found

Verify your skills are configured: henry config get skills

Check hunt sources: henry config get hunt.sources

Review minimum budget threshold

Try manual search: henry hunt --manual "react developer"

Problem: Too many low-quality leads

Increase minimum budget: henry config set hunt.min_budget 2000

Refine skill keywords to be more specific

Add negative keywords to exclude

Email/Communications

Problem: Not seeing emails in Mission Control

Verify Mail.app has messages in inbox

Check permissions: henry setup permissions

Force sync: henry sync email

Problem: Drafts not being created

Ensure email.drafts is enabled: henry config get email.drafts

Check approval settings aren't blocking

Getting Help

# View all commands
henry --help
Get help for specific command
henry hunt --help
Check system diagnostics
henry doctor
Export logs for support
henry logs --export

Community & Support

Documentation: https://docs.henryos.ai

GitHub Issues: https://github.com/shannonlinnan/henry-os/issues

Discord: https://discord.gg/henryos

Email: support@henryos.ai

---