English · 한국어
Haejo lets Claude and Codex use your Mac and browser apps for you.
It opens apps, clicks and types, and checks the result before calling a task done.
It saves the steps as a reusable Flow, so next time it runs with new inputs and no model call.
See which apps it used, what it did, and how each task ended.
Renamed from Tacto (2026-11-09). Release candidates up to v1.0.0-rc.13 were published as Tacto (
Tacto.app,tactocommand); v1.0.0-rc.39 is the first Haejo release. What changes when you upgrade
Haejo in 40 seconds. Eight card receipts to enter into a company system with no API? Ask, and Haejo does it field by field. Every call shows up in the activity log with its goal and reason. Save what it did as a Flow, and next month's six rows replay with zero model calls. The expense system is a demo page; every Safari and TextEdit screen is a real capture taken after each Haejo call. Watch on the site · MP4
Ten recorded scenarios: eight real apps or websites, plus two public test environments.
| App or site | Task and observed result | Recording |
|---|---|---|
| TextEdit | Write workshop notes; separately verify saved disk contents against the document | 28 sec |
| Finder | Sort five files by kind, then by name | 22 sec |
| Google Translate | Enter a synthetic English example; separately check Korean output | 8 sec |
| GitHub | Filter open bugs and sort by comment count | 20 sec |
| UnitConverters.net | Convert 3.5 m to 11.482939633 ft; compare with a separate calculation | 11 sec |
| Markdown Live Preview | Edit the opening section; check heading, list, and bold text | 9 sec |
| Wikipedia | Search Seoul and navigate to History | 19 sec |
| Mac Calculator | Replay the same Flow with different inputs; verify 15 and 12 | 14 sec |
| Two agents | Two tasks take turns on one Calculator: the second is told it is in use and gets through once the first ends | 20 sec |
Also available: product lookup and form filling in public test environments. No purchase or registration was submitted.
The browser demos below were recorded with Python BrowserDriver + Flow in a separate Chromium instance. A Safari window you already have open is found by URL or title and operated directly by the signed helper, as in the film's expense entry. TextEdit stopped when save evidence was insufficient; a separate Save verification then passed. Google Translate's output check is separate from proof of input delivery. The Markdown demo edits only the opening section and leaves other sample content intact.
Recordings include illustrative pointers and capture delays. They show authored Flows executing, not natural-language authoring, and are not speed or token benchmarks. Not every demo completed without intervention. Conditions, results, and limits.
Same-window drag gestures are supported by the signed macOS helper: sliders, text selection and canvas paths, with receiving tests in AppKit and TextEdit. Cross-app file drops are outside this route.
haejo capture <bundle-id> --helper --window 'Exact title' --output window.png
haejo drag <bundle-id> --helper --window 'Exact title' --from 20 80 --to 220 80
haejo resize <bundle-id> --helper --window 'Exact title' --width 600 --height 360Apps that react to the real cursor (hover effects, a character that avoids it) can be exercised with haejo hover: it moves the cursor into the observed window without pressing a button, optionally captures the window while the cursor is there, and puts the cursor back. Moving the mouse yourself stops it. Hover guide.
haejo hover <bundle-id> --helper --to 120 80 --hold 1 --capture during.pngDelegate the work. Inspect the activity. Each request becomes a task
(--task new --goal … --why …). Haejo's in-app history groups calls by task with
the request, the goal, the reason for each call, the target app, outcome and
elapsed time. Search runs, filter failures or unconfirmed completion, and follow
each operation without opening a log directory. Tasks.
Records stay on this Mac. Settings control automatic logging and 7/30/90-day retention. The agent's goals and reasons are kept; screen content, input values and internal agent reasoning are not. Activity history and settings.
Agents can use a reusable, site/app-scoped credential delegation to fill fields or complete login from macOS Keychain or an already authenticated Bitwarden Vault. Values go directly to the signed helper; the agent receives only the result. Includes in-app Vault management, reusable Flow authentication, declared multi-screen login and optional account checks. Credential setup and delegation levels.
haejo parallel jobs.json --helper --json runs one to sixteen checked window jobs, up
to four at once, each with its own signed session and a content-free result receipt; the
Haejo menu shows each live run with its own stop control. haejo windows <bundle-id> --helper lists window IDs for work in different windows of the same
app.
When several agents work on one Mac, each task (haejo task) holds the apps and windows it is
using: another task's actions wait in arrival order, one task at a time uses the front of the
screen, and the app you were using comes back when the task ends (20-second clip, capture conditions). Parallel execution · Helper execution.
First time Claude / Codex → observe the app → author and save a Flow
Next time saved Flow + new inputs → Haejo executes and checks results
Repeat same Flow + different inputs → Haejo executes and checks results
This is computer use: agents read app interfaces, click controls, and enter information for you. Haejo stores the procedure so the model does not have to reason through every routine step again.
| Author once | Replay with new inputs | Intervene when needed |
|---|---|---|
| Create a Flow with Claude or Codex | Resolve targets from fresh observations and check outcomes | Use a model for judgment or supported repairs |
| Model-independent execution format | Zero model calls during normal deterministic replay | Supported repair resumes at the affected step |
Authoring, judgment, and repair still cost model tokens. Automatic selector repair is opt-in: add --auto-repair codex or --auto-repair claude to run or batch.
What if the interface changes or completion is uncertain?
The repair path passes only relevant candidates for supported static-selector failures. It resumes after verified checkpoints without blindly resending actions that may already have completed. It does not recover every UI change or crash. Repair scope.
Native execution uses the existing Haejo menu bar icon for task status and 현재 작업 중단; no extra helper icon appears. Press Esc to stop. In 설정, turn off 작업 중 배너 표시 to hide the upper-right task banner starting with the next task.
The same 11-step Flow ran five times, one step at a time, with different inputs in our own macOS test app, producing 37, 46, 70, 27, and 48, with one completion per job. Pointers and click effects were added for explanation; they are not recordings of system cursor movement.
21-second walkthrough · Unannotated recording · Capture conditions · Landing clip in background Safari
A separate development test completed ten jobs with zero replay-time model calls. Another repaired two changed buttons in one job using two model calls. These are dedicated test-app results, not a reliability guarantee for every business app. Complex scenarios · TextEdit comparison.
Haejo 1.0.5 for Apple Silicon Macs. Requires macOS 27.0 or later.
- Download the notarized DMG (release notes and validation).
- Open it, drag
Haejo.appintoApplications, then open Haejo fromApplications. - In 1. Mac permissions, press Open Settings and allow app control for Haejo Helper (screen recording for Haejo is optional).
- Opening the app already linked the
haejocommand and skill for Claude Code and Codex (2. Connect agent shows it; press it again after moving the app). - 3. First task opens a fresh Claude Code or Codex conversation that creates and verifies a TextEdit welcome note. Check anytime with
~/.local/bin/haejo doctor.
Upgrading from Tacto: install Haejo the same way. Your Tacto data moves to the Haejo folders, and because the app identity changed, macOS asks for both permissions again. What changes
Haejo runs in the menu bar without a Dock icon. Close the window to leave it in the background; the menu bar icon reopens it or quits.
The 1.0.5 DMG is built from source 5dd3716 on Python 3.14: 3,837 regression cases with no failures, Apple notarization and Gatekeeper accepted, and a first install checked on a fresh macOS 27.2 account in a VM. Coming from a release candidate before rc.48, allow app control and screen capture again after upgrading (the identifiers became open330.haejo); web tasks need haejo web install once. Windows and Intel Mac builds are not provided. The in-app onboarding is currently Korean-first. Release evidence · Installation details
Requires uv (it installs Python 3.14, the app runtime, itself), Xcode Command Line Tools, and an Apple-issued code-signing certificate. The launcher and helper must be signed by the same team.
git clone https://github.com/Open330/haejo.git
cd haejo
uv sync
./build.sh
./skill/install.sh
~/.local/bin/haejo doctorFollow doctor and the app’s “permission holder” label to grant macOS permissions to Haejo Helper. Then ask Claude or Codex:
Use the Haejo skill to calculate 12 × 34 in Calculator and verify the result.
Save it as a parameterized Flow so I can run it again with different inputs.
Replay a saved Flow:
~/.local/bin/haejo run flow.json --helperAgent skill · Flow authoring guide
Installation notes and batch runs
If your agent cannot find the skill, restart its session and check ./skill/install.sh --check. The Python distribution is haejo-runtime; the canonical Python import is haejo. The Python wheel alone does not supply the signed native launcher/helper. The permission holder is Haejo Helper (helper/Haejo Helper.app/Contents/MacOS/HaejoHelper) and the launcher is launcher/haejo; bundle identifiers and signing requirements use open330.haejo.*.
Run many rows through one Flow template (one JSON line of params per job):
~/.local/bin/haejo batch template.json --helper < jobs.jsonl
~/.local/bin/haejo batch template.json --helper --auto-repair codex < jobs.jsonlA development-version comparison observed 53.5% fewer total input tokens with Haejo than Sky. Three independent fresh-conversation pairs matched the requested model, reasoning effort, and initial state of the test app.
| Metric | Haejo | Sky |
|---|---|---|
| Successful tasks | 3/3 | 3/3 |
| Total input tokens | 201,447 | 433,312 |
| Mean time | 42.10 sec | 46.17 sec |
This is a small sample. Haejo was slower in one case; it is not universally faster. Full methodology and results.
Cache, output, and repeated-Flow results
2026-10-14 · Codex CLI 0.161.0 · requested model gpt-6.1-sol · medium. Includes initial authoring, execution, and the final response; excludes test setup. Actual serving model, server cache behavior, and billing were not verified.
- Input excluding cache reads: Haejo 22,119 / Sky 50,592 (56.3% reduction).
- Output: Haejo 1,605 / Sky 1,604.
- Total time: 8.8% reduction. This was not a ten-replay comparison.
- Separate 11-step test-app scenarios: 13/13 normal completions, 5/5 expected stops, two button repairs in one job.
- Ten normal repeats in that separate test used zero model calls.
The landing page (source) shows the film, background web work, the activity history, Flow replay and installation. The comparison numbers are on its benchmarks page.
python3 sites/haejo/serve.pyOpen http://127.0.0.1:8787.
Optional macOS fast startup keeps the signed helper warm between commands. Enable it in Haejo Settings (off by default, idle timeout 1–10 minutes), or use HAEJO_HELPER_MODE=warm; per_command overrides it off. Concurrent commands wait up to 10 seconds before helper_busy. Details and measured scope. Haejo supports up to four isolated workers and explicitly scoped independent AX windows in one app; app-wide operations remain exclusive.
Detailed guides are primarily Korean, with code examples and some English references.
Installation · Windows (experimental) · Flows · API · Capabilities · Agent skill
CLI reference
Available on the main branch:
| Purpose | Commands |
|---|---|
| Diagnose setup | haejo doctor |
| Observe apps and controls | haejo apps, haejo observe, haejo menu-state |
| Execute requests and Flows | haejo do, haejo run, haejo replay |
| Compile and parameterize | haejo compile, haejo parameterize |
| Manage Flows and candidates | haejo list, haejo show, haejo flows (save, rename, remove, edit inputs; also the app's 저장된 Flow page), haejo candidates, haejo promote |
| Batch, session, repair | haejo batch, haejo session, haejo repair |
| Tasks and activity | haejo task, haejo logs |
| Remove Haejo | haejo uninstall (links and app to the Trash; --remove-data also history and Flows), or Settings → Haejo 제거 |
| Windows and parallel jobs | haejo windows, haejo activate, haejo parallel |
| Web and files | haejo open-url, haejo web-upload, haejo document-attachments |
| Credentials | haejo auth |
| Evaluate (source checkout) | haejo eval |
Development-only commands:
| Purpose | Commands |
|---|---|
| Experimental VRoid diagnostics | haejo vroid-focus, haejo vroid-drag — separate build with HAEJO_ENABLE_EXPERIMENTAL_FOREGROUND=1; excluded from the default build |
Check haejo --help for your checkout. Use the signed launcher for native work and --helper where required.
All guides and validation records
- GUI, branding, and independent review
- haejo visual identity
- haejo landing engineering 2026 10 15
- haejo recorded demos 2026 10 15
- haejo everyday examples 2026 10 15
- haejo browser examples 2026 10 15
- release readiness
- Beta participant guide
- First-run quality review
- haejo native release fixes 2026 10 16
- haejo peer review 2026 10 16
- haejo branding
- api
- artifact receipts
- benchmark records
- capabilities
- claude adapter
- completion plan
- context paging
- delivery evidence
- evaluation
- input observation
- permission onboarding
- installation
- Automatic access records
- Goal-scoped tasks
- Acting on consent the user already approved
- Menu approval for confirm steps (opt-in)
- menu discovery
- model deadlines
- native visual
- native window input
- Safari capability matrix: which route delivers each web action
- Haejo automatic repair — scope and limits
- Haejo complex scenario validation
- Haejo and Sky matched comparison
- provider envelope
- recipes
- Long Flow waits and paused deadlines
- rtf receipts
- save directory observation
- textedit save
- visual
Haejo · Local execution. Reusable computer use.
Release candidate · MIT License
Runtime updates and validation
- dispatch-journal
- journal-reconciliation
- menu-readiness
- haejo-attended-operation-design
- haejo-authoring-literal-validation
- haejo-capture-continuation-validation
- Vault-backed credential delegation validation
- Same-app window concurrency measurement
- iPhone target spike and execution verification (experimental contract/probe; physical execution not qualified)
- Inline task lifecycle and document polling measurements
- haejo-latency-profile-20261019
- haejo-native-matched-validation-20261019
- haejo-native-resumption-validation
- haejo-provider-paging-validation
- haejo-textedit-saved-state-validation
- window-preparation-diagnostics
- Preview 3 runtime update




