Companion Tools

Agentum works out of the box, but most of its superpowers come from the tools it connects to. None of them are required to run the app — install the ones that match how you want to use it. This page is the shopping list; each tool’s deeper setup lives on its own page.

Tool What it unlocks Required?
An LLM API key (or the built-in provider) The intelligence behind your agents Effectively yes
Claude Code or Codex Building and improving agents with AI (Create, Improve, Sidekick) For building agents
Telegram Chatting with your agents from your phone, approvals, the Mini App Optional
Google account Calendar and Gmail integrations Optional
Chrome + Agentum Bridge extension Browser-driven research features Optional

A coding CLI: Claude Code or Codex

When you build a new agent or improve an existing one, Agentum hands the actual code-writing off to an agentic coding CLI — your choice of Claude Code (Anthropic) or Codex (OpenAI). Agentum drives the CLI for you, either in a terminal window or embedded right inside the app, so you never have to learn the tool itself. But the CLI does need to be installed on your Mac.

If you skip this now, that’s fine — the moment a Create or Improve flow needs the CLI, Agentum detects that it’s missing and offers to install it for you with one click.

Installing Claude Code

Claude Code is the default harness, and the only one that also supports handing off to the Claude desktop app.

Open Terminal (⌘-Space, type “Terminal”) and paste:

curl -fsSL https://claude.ai/install.sh | bash

The installer puts the claude binary in ~/.local/bin. First time you use it, it walks you through signing in with your Anthropic account — a Claude Pro/Max subscription or an Anthropic API key both work. Full docs: docs.claude.com/en/docs/claude-code.

To verify:

claude --version

Installing Codex

Codex is OpenAI’s coding CLI. If you already have a ChatGPT Plus/Pro account, this may be the cheaper path.

curl -fsSL https://chatgpt.com/codex/install.sh | sh

The installer puts the codex binary in ~/.local/bin. On first run it signs you in with your ChatGPT account. Full docs: developers.openai.com/codex/cli.

To verify:

codex --version

Telling Agentum which one to use

Open System → Settings → LLM Provider and pick under the Coding assistant dropdown — “Claude Code (Anthropic)” or “Codex (OpenAI)”. You can switch any time; the choice applies to newly started build sessions, and it’s independent of your chat LLM (you can chat with Gemini and code with Codex). See Choosing Your LLM & Coding Harness for the full picture.

Telegram

Telegram gives your agents a voice on your phone: messages, approvals you can tap, slash commands, and the Telegram Mini App. You’ll need:

  1. The Telegram app — telegram.org/apps on iPhone, Android, or desktop. Sign up with your phone number if you’re new.
  2. A bot of your own — created in about a minute by messaging @BotFather. Free, no developer account needed.

The step-by-step (creating the bot, getting the token, connecting it to Agentum, finding your user ID) lives in Telegram Setup.

Google account

Connecting Google enables the Google Workspace integrations — Gmail, Calendar, Drive, Docs, and Tasks — so agents can read your schedule, find free slots, and coordinate meetings. There’s nothing to install: Agentum ships with the OAuth client built in. Click Connect Google in System → Settings → Profile (or from the Account menu in the sidebar), approve the standard Google consent screen in your browser, and you’re connected.

If your Google account is managed by an organization (Google Workspace), your admin may need to allow the app before consent succeeds.

Chrome + the Agentum Bridge extension

Some research-oriented agents can drive a real browser session through the Agentum Bridge Chrome extension. If you have a licensed install, pairing is automatic: install the extension, and the first time it connects to your running Agentum it’s trusted and linked — no token copy-paste. You can unpair it later from the Chrome bridge card in Settings.

Skip this unless an agent you install asks for it.

Next steps