OpenCore

OpenCore is a macOS assistant that can carry out tasks on your computer through a local app experience with a CLI and dashboard.

OpenCore can help with:

• using apps and websites on your Mac
• handling repetitive workflows
• sending tasks from the terminal, dashboard, or Telegram
• creating scheduled tasks
• storing local website login details for reuse

Requirements

• macOS
• Node.js and npm
• a ChatGPT API key
• Terminal access

Install

Install OpenCore globally:

npm i -g @opencoreai/opencore

Run first-time onboarding:

opencore onboard

Start OpenCore:

opencore engage

Onboarding

On first use, run opencore onboard. If onboarding has not been completed yet, opencore engage will start onboarding automatically.

OpenCore will ask for:

• your ChatGPT API key
• the manager agent provider and model
• any extra manager-provider API key required for non-OpenAI manager models
• the name OpenCore should use for you
• the tone OpenCore should use
• optional Telegram connection
• optional skill selection

OpenCore still requires an OpenAI API key because computer-use execution remains OpenAI-backed in the current production release.

Permissions

To let OpenCore control your Mac, allow your terminal app in:

1. System Settings -> Privacy & Security -> Accessibility
2. System Settings -> Privacy & Security -> Screen Recording

Use

Run OpenCore:

opencore engage

Stop OpenCore:

/exit

While OpenCore is running, you can:

• send tasks in the terminal
• use the dashboard in your browser
• send tasks from Telegram if connected

Dashboard address:

http://127.0.0.1:4111/dashboard/

Dashboard

The dashboard lets you:

• send tasks
• view activity
• manage Telegram
• manage saved login details
• manage skills
• view screenshots

All dashboard data stays local on the user’s Mac.

Saved Logins

OpenCore can save website login details locally so they can be reused later.

You can:

• save an email and password for a website
• set a default email for new account creation
• set an email provider
• choose whether automatic email activation is allowed

Automatic email activation is off by default.

If you turn it on, OpenCore may open your email provider to read verification codes or links needed to complete sign-up flows.

Only enable that if you trust the current machine and session.

Telegram

OpenCore can connect to Telegram so you can send tasks from your phone while the CLI is running.

Scheduled Tasks

OpenCore can create scheduled tasks and check whether missed work needs to be completed.

Useful commands:

/schedules
/check-heartbeat
/unschedule <schedule-id>

Commands

Start OpenCore:

opencore engage

Run onboarding again:

opencore onboard

Run setup manually:

opencore setup

Update OpenCore:

opencore update

Set ChatGPT API key:

opencore config set-key openai

Set a manager-provider key:

opencore config set-key anthropic

Show current config:

opencore config show

Reconnect Telegram:

/telegram reconnect

Disconnect Telegram:

/telegram disconnect

Update

To update OpenCore:

opencore update

opencore update installs the newest published OpenCore release. That updates the packaged CLI, dashboard, runtime/agent logic, prompts, templates, shipped assets, and dependency versions included in that release.

Or install the newest published version directly:

npm install -g @opencoreai/opencore@latest

Release Verification

For release verification in the repo:

npm run verify:release

OpenCore does not require the GitHub repository to be public in order for the npm package to work. Only the published npm package needs to be available to the installing user.

License

OpenCore is distributed under the OpenCore Personal Use License 1.0.

It is not open source.

The license prohibits:

• modification
• redistribution
• resale
• creating derivative works
• commercial use

See LICENSE for full terms.