Connect an AI agent

Lifebase works with an AI agent that can access your vault and follow its instructions. Install and sign in to that agent separately. AI accounts, subscriptions, and API credits are separate from Lifebase and follow your provider’s terms.

Connect your tool

The installation wizard detects supported local agents and lets you choose which ones to configure. You can repeat setup later using a tool identifier:

lifebase agent setup --tool codex
lifebase agent setup --tool claude
lifebase agent setup --tool gemini

Run only the command for the tool you use. Open the installed Lifebase folder as that tool’s working project, then ask it to read the vault’s AGENTS.md before editing notes.

Agent	CLI identifier	Setup behavior
Hermes	hermes	Registers vault skills; can set the Gateway working directory
OpenClaw	openclaw	Registers vault skills in its active configuration
Codex	codex	Verifies project-local skills
Claude Code	claude	Creates a file to load the vault instructions, plus links to its skills
Gemini CLI	gemini	Creates a file that connects the tool to the vault instructions
Cline / Kiro	cline / kiro	Creates project-local skill links
Google Antigravity	antigravity	Verifies project-local skills
OpenCode	opencode	Verifies project-local skills
Cursor	cursor	Verifies project-local skills
GitHub Copilot	copilot	Verifies project-local skills
Windsurf	windsurf	Verifies project-local skills

Setup does not install an agent, invoke a model, sign in to an account, or upload vault content. Once you use the agent, its own tools, permissions, and provider data practices apply to the content you give it.

Verify the connection

lifebase agent status --tool codex

Replace codex with your tool’s identifier. Ask the agent to identify the connected vault and available Lifebase workflow before starting onboarding. If a tool is not detected, check its separate installation and command availability.

For Hermes, use the setup guide. OpenClaw’s optional workspace move physically relocates the vault and is off by default; review that choice before enabling it.

Existing configuration

Setup preserves unrelated skills and refuses conflicting names instead of overwriting them. If an existing instruction file needs a manual import, follow the reported instruction. Repeating setup can repair Lifebase-managed links.

Connecting an agent does not automatically schedule recurring jobs. Check Automation for the required maintenance job and its verification.