01 sign-in
Tokens are never displayed
The app checks for a supported local Codex sign-in and its state. Authorization file contents are not rendered in the interface or added to your portrait.
Quick start
About ten minutes
to your own agent
Download the app, open it and complete one introduction. CapyAgent first checks what already exists on the device, then asks only for what is actually missing.
A model is enough for the first conversation. Channels, CRM, email, advertising and scheduled work can be connected later.
Step by step
What happens after download
01
Open the installer
Download the DMG on Mac, EXE on Windows or AppImage on Linux. The app already contains the core; a normal conversation needs no separate Go, Python or Docker installation.
02
Review the device inspection
CapyAgent shows the system, resources and known local tools. It reads only predefined safe locations and does not crawl the disk.
03
Check the sign-in method
An active local Codex sign-in through a ChatGPT subscription is used automatically if no other provider is configured. If none is found, the wizard asks you to choose a model.
04
Review discovered memory
You see short previews from known rules and memory files. For every excerpt, ask whether it is about you and still current. Add only useful material to the draft.
05
Save the portrait and write
Edit the draft, save it with a separate action and enter chat. On later launches, a configured agent opens the conversation immediately.
Under your control
Automatic does not mean silent
02 memory
A draft comes first
Discovered text does not become memory automatically. You choose a fragment, edit it and save the final portrait with a separate action.
03 secrets
Suspicious material is skipped
Authorization, key and session files are not read. Lines that look like tokens, passwords or private keys are removed even from ordinary notes.
First conversation
Where to begin
First check that the agent understood you and its boundaries. Then connect one work system and ask it to discover the structure, so you can verify the result with your own eyes.
- “What do you already know about me, and where did it come from?”
- “Which tools and work systems can you access right now?”
- “Show what is configured in my Bitrix24: pipelines, stages and fields.”
- “Compare the deals you found with the count declared by the portal and name any gap.”
Before changing data, the agent should show the exact action and wait for single-use confirmation. Start with reading and verification.
For terminals and servers
One-command installation
If you do not need the graphical app, install the CLI in your user profile. You can download and inspect the script in the open repository first.
bash
# Linux, macOS or WSL2 - no sudo$ curl -fsSL https://capyagent.com/install.sh | sh
The user installer places the program in ~/.local/bin without sudo. For a permanent server service, follow the server install guide.
If something stalls
Common first-launch questions
ChatGPT is open, so why was no sign-in found?
An open browser tab does not give the app safe local access. It needs an active Codex CLI sign-in with an available local auth file. Otherwise choose an API provider or local model in the wizard.
It found someone else's or stale memory
Do not add it to the draft. Discovery alone changes nothing. If one part is useful, take only that part and correct it before saving the portrait.
macOS or Windows does not trust the app
Match the file against the official release page and its checksums. What the system says and what to click is on the installation page.
Can I use it without a CRM or Telegram?
Yes. Start with local chat and a model. Connectors and channels can be added later from the panel and are not required to test onboarding and personal context.
Can I install it inside my company for free?
Yes, for your own company's internal work. The paid license applies to an integrator who installs or resells CapyAgent to a third party for money.
The agent is running - connect one real task
Do it yourself for free, or order diagnostics and a pilot against your data.