Skip to content

CapyAgent - a program on your own computer.

For technical specialists

How it is built
inside

This page is for whoever will vet us before the purchase. It holds what was taken off the home page so it would not get in the way of the business conversation: which ways of losing data each connector is written around, what it connects to, and which platforms already work and which do not yet.

The program is distributed under BSL 1.1 and the licence terms are published. The repository is closed for now, so what follows are not links to code but rules and behaviour visible on your own machine: every one of them can be checked by running it.

01 / The difference

An ordinary integration knows the API methods.
This one knows where they lie

This is the line between "the service is connected" and "the figure can be trusted". Every connector is written around a specific way of losing data silently.

01

A batch request loses pages silently

Bitrix serves batch with halt=0 and carries on after an error inside the batch. Code that looks only at the response status gets a partial export and treats it as complete.

batch completeness check

02

An error with status 200

Direct queues heavy reports and answers 201 or 202. Treat "not 200" as a failure and you declare phrase reports unavailable. Treat 200 as success and you never read the error in the body.

parse the body, not the status

03

Completeness that is not there

The service promised 4,812 records and returned 3,900. The honest answer is to name the gap and stop. An ordinary library returns whatever it managed to collect, and you see the difference a month later in a report.

promised against received

04

An account structure cannot be guessed

Fields, pipelines, dictionaries and smart processes differ for everyone. The program first discovers how your particular portal is arranged and only then counts. A schema assumed in advance breaks on the second client.

discover before analysis

02 / Permissions

What is forbidden in the code itself,
not in a manual

These are not settings that can be flipped by accident. The refusal lives in the single door every call has to pass through.

01 CRM

Read-only

Methods of the form .list, .get and .fields are allowed. Anything ending in .add, .update, .delete or .set*, plus batch and any unfamiliar name, is refused before sending: the request never leaves for the portal. batch is refused separately because it carries its commands inside a parameter, so the method name says nothing about what is in there.

02 shell

Out of the box it runs no commands

Running commands on the machine is off by default: a client who configured nothing will find no shell behind the program. The capability exists and is switched on by you separately - the "Run commands on this machine" toggle in the settings. Until 23.08.2026 it did not exist at all, and the owner enabled it deliberately, so we say it here instead of leaving it out.

03 approval

Dangerous actions are held back

Sending an email or a message, clicking and typing on a web page, answering a page dialog, a bot joining a meeting - all of it is shown before execution with the exact operation name and its arguments. Consent is one-time: next time it asks again. One exception is named outright: since 04.09.2026 commands on the machine can be granted a standing permission with the word "always", and it works for those alone.

03 / Systems

It connects to what
you already run

Nothing has to be migrated: the program comes to your systems instead of calling you into its own. There are 12 built-in connections - they ship inside the program itself, and the list is pinned name by name by a test in the code. Below are those, plus two that are NOT built in and are installed separately: the Calltouch plugin and the Alice voice channel. Next to each one it says whether we checked it on a live account or only against the service documentation so far.

Bitrix24 portal structure, fields, dictionaries, deals and smart processes checked on a live account
Yandex.Direct campaigns, groups, reports, spend and API limits checked on a live account
UIS / Comagic calls, web forms and the quality of source tagging checked on a live account
Web search search without a key, and with a key Yandex Search API, SearXNG and Brave; one shape of results keyless checked live; with a key, from the documentation
Browser reading pages drawn by scripts; actions require approval reading live; actions ready, live run still ahead
Documents reading PDF, Word and Excel from the exchange folder works with no keys; PDF needs the system pdftotext
Yandex.Mail folders, search and reading messages ready, waiting for your access
ZenMoney accounts, balances and transactions; writing requires approval ready, waiting for your access
VK community messages and Long Poll state ready, waiting for your access
Roistat analytics and comparison of attribution models ready, waiting for your access
MeetScribe meeting transcripts and minutes ready, waiting for your access
Telegram as yourself reading your own private correspondence and sending as you off by default; the list of chats it may write to is empty until you fill it in
Calltouch calls, enquiries and ad sources a separate plugin, not one of the built-in ones; not checked live
Alice a voice skill as one more surface for the conversation a conversation channel, not a connection to a system; not one of the built-in ones

04 / First run

What happens after the download

01

You download the app

Pick the installer for macOS, Windows or Linux. An ordinary start needs no Git, Go, Docker or terminal commands.

02

CapyAgent inspects the machine

It checks only known safe places: the system, resources, local tools, an available model login and context files. It does not scan the whole disk.

03

It shows you what it found

You see short excerpts from CLAUDE.md, AGENTS.md, MEMORY.md and other known files. Authorisation files and strings that look like secrets are not read.

04

You confirm the context

The app asks outright whether what it found really is about you. What you keep goes into a draft only; anything out of date can be corrected before it is saved.

05

You connect the work

Add a CRM, ads, mail or another service and say in ordinary words what you need. Everything that matters stays visible in the panel.

05 / Install

From download
to the first answer

Ready-made apps for Windows, macOS and Linux; for a server there is still the one-line install. We name no timings: we have never measured one, and inventing it would be dishonest. Step by step on the quick start page.

bash
# Linux, macOS or WSL2 - install without sudo$ curl -fsSL https://capyagent.com/install.sh | sh # or download the desktop app on the install pagemacOS · Windows · Linux # after the intro, just ask in ordinary words> how many enquiries came in this week and from which sources?138 enquiries. Direct 41, Avito 36, direct traffic 44, organic 17.the portal promised 142 and returned 138: four records with no source, show them?

That last line is the whole difference: incomplete data is named out loud instead of being hidden behind a confident answer.

06 / Honestly

What already works
and what does not yet

This list is kept on the public site, not in correspondence. Nobody wants to learn about an unfinished part in the third week of a pilot, and we want it least of all.

Linux and server AppImage, one-line install, service, schedule, channels and connectors works
macOS Apple Silicon DMG and ZIP are built on macOS and pass the core start; the package is not signed yet ready with a caveat
Windows 10/11 x64 the installer is built on Windows and passes the core start; the package is not signed yet ready with a caveat
Web interface and extension chat, settings, memory, jobs and control in the local panel works
Android a client skeleton in the repository, too early to call it an app skeleton
Cloud a dedicated perimeter on our hardware so it runs with your laptop shut early access
Multi-tenancy this version is built for a personal or dedicated perimeter, not a shared SaaS not included

07 / Next

You have checked it - now see it on your own data

Diagnostics shows what comes off your hands on your systems and what does not. If you would rather try it yourself first, install it and see: that part is free.