faq

Questions, answered.

• What runs where
• Your data
• Security
• Requirements
• Pricing
• Uninstall
• Support

What runs where?

Everything that touches your code runs on your Mac. Codemany.app and its codemany daemon register a fresh, single-use GitHub Actions runner for each job; the job runs on your Mac and reports to GitHub. GitHub still schedules the jobs and shows the logs. Our servers only issue licenses (api.codemany.com) and serve this site and the downloads.

What data leaves my Mac?

• To GitHub: the API calls a runner needs, made directly with your token.
• To us: your GitHub id, login and email when you start a trial or subscribe, a hashed device id and your Mac's name, and a daily license check. Bug reports only when you send one.
• To Stripe: your payment details, on Stripe's checkout page.

Your GitHub token stays in Codemany's Keychain vault (com.codemany.vault) on your Mac. No analytics. Details: Privacy Policy.

Is it safe?

A self-hosted runner is not a sandbox. Only run workflows you would run in your own terminal.

• Public repos are opt-in. Codemany refuses a public repository unless you opt in for that repo, and it also refuses one whose fork pull-request approval setting is too weak or whose workflows use risky triggers. It re-checks every 30 minutes, because a repo can be made public later.
• One runner per job. Each job gets a just-in-time registration and a fresh copy of the runner; its work directory is wiped afterwards.
• Isolation modes. host, the default and today's only released mode: jobs run as your macOS user. user (a separate, hidden macOS user per runner, wiped after each job) and vm (a clean macOS VM per job, experimental) are being explored and are not released.
• Credentials. The token's Keychain item trusts only Codemany.app and its daemon. The LAN dashboard is read-only from other devices unless you set an admin token.

Questions about the security model? DM @arpwal on X.

What do I need?

• A Mac with Apple silicon on macOS 14 or later.
• A GitHub account that can add self-hosted runners to the repository or organization (repo admin, or org owner).
• Workflows that say runs-on: [self-hosted, codemany]. Sample workflow.

How much does it cost?

$20/month per Mac, after a 14-day free trial with no card. One trial per GitHub account and Mac. Cancel anytime from Manage Subscription in the app. Refunds within 14 days of a charge: see the Terms. A license keeps working for 7 days offline.

How do I uninstall it completely?

1. Cancel your subscription first (Manage Subscription in the app). Uninstalling does not cancel it.
2. Let running jobs finish, then choose Settings › Fleet › Stop & Uninstall. This stops the runners and removes Codemany's background item (its LaunchAgent).
3. Quit Codemany and move /Applications/Codemany.app to the Trash.
4. Remove its files and Keychain items in Terminal:

rm -rf ~/.codemany                    # settings, runners, job work dirs, logs, license
rm -rf ~/Library/Application\ Support/Codemany \
       ~/Library/Application\ Support/com.codemany.app \
       ~/Library/Caches/com.codemany.app
rm -f ~/Library/LaunchAgents/com.codemany.daemon.plist   # only from 0.2 or older
defaults delete com.codemany.app
security delete-generic-password -s com.codemany.vault        # GitHub token
security delete-generic-password -s com.codemany.app.license  # license, if present

On GitHub, remove "Codemany" under Settings › Applications (or delete the token you gave it), and delete any offline runners left under the repo's Settings › Actions › Runners.

How do I get help?

Send a direct message to @arpwal on X. For bugs, use Report a Bug in the app: it files an issue for us and shows you exactly what it sends. Release notes are on the changelog.