Notiamo fit start AI agent on di open comments and tasks of one project. Di agent go make di changes, and one person for your team go approve dem. Run fit happen for Notiamo servers, or for computer wey you own. Dis page na about di second way: di runner, small program wey you go install for your machine. E na for di agency team.
Wetin di runner be
Di runner dey wait for di agent runs wey your organization put for line for Notiamo. For each run, e go clone di repository (or connect to di WordPress site), start Claude Code with di run instructions, send Notiamo wetin di agent dey do, and report when e finish.
- E no hold any Claude credential. E dey start di
claudeprogram wey already dey di machine. Di runner sessions dey use dia own config folder, so dem dey separate from yours. Di sign-in itself na Claude Code own, Claude Code dey keep am. - E no be Claude login inside Notiamo. Notiamo no dey ever see or use your Claude account. Di runner just dey run your own Claude Code, for your machine, for your own work.
Install am
Wetin you need:
- Node.js 22 or later;
- Claude Code 2.1.314 or newer;
- git 2.31 or newer;
- for Linux and WSL2:
bubblewrapandsocat(Debian or Ubuntu:sudo apt install bubblewrap socat). For macOS nothing more to install.
Then:
- For Notiamo, open Settings › Agent runs. For di Runners card, press New runner and give am name. Copy di token. Dem go show am one time only.
- For di machine, run:
npx @notiamo/runner init
- Paste di token.
initgo check say Claude Code dey work, run Claude Code sign-in for di runner, then install di service and start am. - For di project, set Where the agent dey run to Own machine.
When init finish, di runner don dey run. E go start again by itself after login or restart.
Commands
| Command | Wetin e dey do |
|---|---|
npx @notiamo/runner init |
E dey set up di runner: token, Claude Code sign-in, install and start di service. |
npx @notiamo/runner@latest update |
E dey move di runner go di newest version. Di token, di name and di sign-in go stay. |
npx @notiamo/runner status |
E dey tell you if di service don install and if e dey run, and show di last log line. |
npx @notiamo/runner logs |
E dey show di last 50 lines of di log. |
npx @notiamo/runner stop |
E dey stop di service until di next login or boot. |
npx @notiamo/runner uninstall |
E dey remove di service. Di runner folder go stay. |
npx @notiamo/runner env <projectId> |
E dey make or show di env file wey dis machine dey give di runs of one project. |
npx @notiamo/runner start |
E dey run for foreground. Di service dey run dis one; you hardly need am. |
Di service na launchd agent com.notiamo.runner for macOS, Scheduled Task “Notiamo runner” for Windows, and systemd user unit notiamo-runner for Linux.
Two runners for one machine
npx @notiamo/runner init --profile staging dey set up second runner, wey separate. E get im own folder (~/.notiamo-runner/profiles/staging) and im own service. Add --profile staging to every command of dat runner. Profile name get letters, digits and dashes, 1 to 32 characters.
Wetin di agent fit touch and wetin e no fit touch
Each run get im own Claude Code settings file. Three things dey keep di agent for im place.
File tools dey stay inside di run folder. Claude own file tools (read, edit, write, search) dey refuse anything outside di folder of di run. Any call wey go ask for permission dem go refuse am, because nobody dey dia to answer.
Shell commands dey run inside di operating system sandbox. For macOS (Seatbelt) and for Linux or WSL2 (bubblewrap and socat), every command wey di agent run for shell dey locked inside. If di sandbox no fit start, di run no go start.
No credential of di machine dey reach di agent. Claude Code dey get only short list of environment variables (PATH, HOME, USER, LOGNAME, SHELL, LANG, LC_ALL, LC_CTYPE, TERM, TMPDIR, TZ, XDG_*, di proxy and certificate settings) plus di run own. E no dey ever get SSH_AUTH_SOCK, GH_TOKEN, GITHUB_TOKEN, NPM_TOKEN, AWS_* or ANTHROPIC_*. Di agent git no dey see any global or system git config.
Wetin di shell sandbox allow and wetin e deny:
- Reads dem deny: di folders of other projects (other runs wey dey run at di same time too), di runner own files, and your credential files and folders (SSH keys, cloud logins, package registry logins, git credentials).
- Writes dem allow: only inside di run folder and di project package cache folder wey dey beside am. Di run
.git/hooksand.git/configna read-only. - Network dem allow: GitHub, npm, Notiamo, di WordPress site (for WordPress run) and di hosts wey you add under Extra hosts wey di agent fit reach for di Runners card. Dem go refuse everything else.
Di agent no dey ever push and e no hold any credential. Di runner go push di run branch by itself after di agent work.
When run end, di runner dey stop every process wey di agent leave behind, like dev server.
Di keychain for macOS
Di macOS sandbox no dey close di keychain well well. So no keep any GitHub login inside di keychain of di user wey dey run di runner (init dey warn you when e find one). Di safest setup na separate macOS user wey get im own keychain.
Windows
Plain Windows no get shell sandbox. Text inside comment fit then make run do any command as you. Run di runner inside WSL2. For plain Windows di runner no go start unless you add "allowUnsandboxed": true to im config.json; do am only for machine wey no hold any other thing.
Several runs at once
For di Runners card you go set How many runs at once: 1 to 3. Each run dey use your Claude plan, so keep di number to wetin di plan get space for. One project no dey ever run two times at di same time: second run for di same project go wait for di first.
Each run wey dey run at di same time get im own slot folder. Di sandbox of one run no fit read di other slots.
Runner for one client
When you dey make runner, you fit limit am to one workspace under E dey run for. E go then take only dat client runs. To set am up for di client computer: install Claude Code dia, run npx @notiamo/runner init, and paste di runner token. Na di Claude login for dat computer go pay for di runs, so sign in with di account wey suppose pay.
Setup and test commands
Clean clone no get any installed package. Tell di agent how to install dem and how to test. Open di project agent settings and fill Setup command and Test command, one line each.
- Di agent dey run di setup command one time, before im first change. Example:
pnpm install --frozen-lockfile. - Di agent dey run di test command before each commit. Change wey fail am, dem go fix am or undo am. Example:
pnpm typecheck && pnpm lint. - Di agent dey run both by itself, inside di same sandbox as im other commands. Di package registry must dey di allowed hosts. GitHub and
registry.npmjs.orgdey dia by default. Add any other one (PyPI, crates.io, private registry) under Extra hosts wey di agent fit reach for di Runners card. - Each project get package cache folder beside im clone. npm, pnpm, Yarn, Corepack, Bun, pip, uv and Composer dey keep dia caches dia, because di sandbox dey close di usual places inside your home folder. Di folder dey stay between di runs of di project and e go go with di clone. E no dey for plain Windows.
- Keep di test command light. Test wey need Docker no fit run. Test wey need database fit run only when di project env file point to one wey you dey keep running (see below).
Di agent dey commit as “Notiamo agent”, one plain line for each item. Di runner dey turn off Claude Code “Co-Authored-By” trailer and “Generated with” line, so di repository no go show any AI co-author.
Environment for your own projects
Run for GitHub project dey get clean clone and nothing else. For software project of your own, di tests fit also need database, file store, mail catcher and .env. Di runner machine dey give dem to di runs of one project with plain file:
npx @notiamo/runner env <projectId>
<projectId> na di last part of di project page address for Notiamo. Di command dey make ~/.notiamo-runner/env/<projectId>.env, wey only you fit read, and e dey print di path. Put one KEY=VALUE for each line. Di next run of dat project go get di variables inside im shell, and dem go tell di agent dia names, never di values. Remove di file to take dem away. Di file no dey ever leave di machine: Notiamo no know say e dey.
When di file dey, di run shell fit also reach services for 127.0.0.1 for macOS: your Postgres, file store, dev server. You dey keep dem running; di agent no fit start dem, and Docker dey outside im reach. For Linux di sandbox get im own network, so 127.0.0.1 dia no be di machine own: bind di services to di machine network address and add dat host under Extra hosts wey di agent fit reach.
Rules:
- Development and test values only. Di agent dey run shell commands and e fit read every variable. Never production key, never password wey you dey use for another place.
- Dem dey ignore
PATH,HOME, di proxy and certificate variables,NODE_OPTIONS,NODE_TLS_REJECT_UNAUTHORIZED,NOTIAMO_*,GIT_*,CLAUDE_*andANTHROPIC_*, and di log dey tell you. Di file fit change wetin di agent commands see, but e no fit change how Claude Code dey talk to Anthropic and Notiamo. - Values wey be 6 characters or more dem dey mask as
[secret]inside di transcript wey Notiamo get. Short values (1,true) dem no dey mask. - Keep How many runs at once at 1 when di projects of one runner dey share database through dia env file. Two runs at di same time go run dia tests on di same database.
WordPress sites
Di connection dey for di project Website access card: application password, and if you want, SSH or FTP. Di runner dey remember di SSH server key for im first visit and e go refuse server wey show another key later. Run dey go like dis:
- Backup before. With SSH, di runner go export di database and upload am to Notiamo, compressed, 200 MB at most. Notiamo dey keep am for 30 days. With FTP or di API only, no backup dey.
- Di agent dey work through di allow-list below.
- Site check after. Di runner go open di site and check say e still dey answer.
- Restore if e fail. If di check fail, di runner go restore di database.
Wetin di agent fit run with wp-cli, for each group (you set am for di project):
- Content:
post *,term *,menu *,media import,option get,option update. - Database:
search-replace(only di old and di new text; e no dey ever touch di users or di options tables),cache flush,rewrite flush,transient delete. - Plugins and themes:
pluginandthemewithlist,activate,deactivate,update. - Information:
core version,site list,db size. - Files: no wp-cli command; di agent dey use im file tools. Dem dey write styles, scripts and other files wey di server no dey run.
- PHP files (off by default): di file tools fit also write PHP. PHP file na code wey dey run for your server, and WordPress run no get approval step: di change dey live at once. Turn am on only for site where you trust everybody wey fit write comment.
- Never, unless you choose “Allow everything”:
eval,eval-file,shell,user *,db query|import|reset|drop|export,plugin install,theme install,core update|download.
Wetin dem keep where
Everything dey inside ~/.notiamo-runner.
| Path | Wetin e hold |
|---|---|
config.json |
Notiamo address, di runner name and di runner token. Only you fit read am. |
claude/ |
Claude Code config folder for di runner: im sign-in and sessions. |
projects/ |
Di working copies of your projects, one folder for each project inside each slot. Project wey nobody use for di number of days wey you set for di Runners card, dem go remove am; di next run go clone am again. |
git/ |
Di runner own copies of your repositories. Di agent no fit read or write dis folder. |
env/ |
Di env files wey you make, one for each project. |
runs/ |
Di Claude Code settings of each run wey dey go on. No secret. Dem delete am when di run end. |
runner.log |
Wetin di runner do, with no secrets. |
state.json |
Di ids of di runs wey dey go on. After restart, dem go report each one to Notiamo as failed. |
Di secrets of a run (WordPress passwords, di run own tokens) dey come from Notiamo with di run and dem dey live inside memory only. Di agent dey get dem as environment variables, never inside file. Wetin di agent print, dem dey clean dem comot from am before dem upload di transcript.
Di runner no dey ever use di machine git credentials. Each run dey get from Notiamo one GitHub token wey dey work for one hour and for di run repository only. Di runner dey keep am inside memory and use am for im own fetch and push. Notiamo dey open and merge di pull request.
Stop a runner
For di Runners card, press Disable to pause runner, or Delete to remove am. Token of runner wey you delete go stop to work at once.