Docs
HolyAgent
Installation on a Mac, a server and a phone, the enrollment key, channels, skills, memory and settings history.
HolyAgent is the agent on your machines and the only thing installed on your side. Model keys, channels and memory live on the machine; only tasks, statuses and run transcripts reach the cloud, as you configure them. No telemetry.
Installation
| Where | What to install |
|---|---|
| Mac (Apple Silicon) | the app from the release feed; it updates itself, data in ~/.holyagent survives updates |
| Server | the Docker image is being prepared for publication; write to us if you need it earlier |
| iPhone | the phone shell is in testing, access on request |
The agent panel opens locally on the machine where it runs; sign in with the same account as the workspace.
Connecting to the organization
- In HolyCode: Workforce → Nodes → “Agent enrollment key…”, the agent name (lowercase Latin letters, digits,
.,_,-) and a validity period. - In the first-run wizard: the enrollment key and a model key. If the panel is not needed, an agent on a server needs only environment variables: the organization address, the agent name and the enrollment key.
- The agent enrolls, receives a permanent key and appears in Nodes with a status and version. The one-time key is spent.
Optionally you can set the countries and languages the agent works with, the set of connectors and how many tasks it takes at once (5 by default).
Models
Anthropic, OpenAI and Google keys are entered in the agent panel and stored encrypted on the machine. There can be several providers: the agent switches the model as the role and task settings say. Tokens are paid to the provider directly.
Channels
WhatsApp, Telegram, Instagram and voice are connected in the agent panel and run physically on this machine: customer conversations never pass through the cloud. The connection wizard shows what each channel needs. An outbound message from an r2 role is sent only after approval in the workspace.
Skills and memory
A skill is a folder with SKILL.md: what the agent can do and how. Skills are enabled per agent in the panel and move between installations with the company package (in Russian). Memory, what the agent knows about your business, lives in the agent folder on the machine.
Settings history
Every save of the agent settings writes a version (the last 50 are kept). Agent panel → settings → More → Settings history: what changed and a button to roll back to any version; the rollback itself becomes a version.
Several machines
Every machine is a separate node with its own enrollment key. Roles and channels can differ per node: for example, WhatsApp only on one machine and voice on another. A task goes to the node that has all the needed connectors.