TrueCal CLI

Use TrueCal with your AI agent.

Q: Can I use TrueCal from my AI agent?

Yes. Install @truecal/cli, authenticate once, and use JSON commands from agents such as Codex, Claude Code, Cursor, or a terminal agent.

Q: Can an agent write to my TrueCal log?

Only after you explicitly grant write access. Read access and meal logging writes are separated so users can start read-only.

TrueCal is not just one app surface. Use it in the web app, mobile app, ChatGPT, Claude, Codex, Claude Code, Cursor, and any agent that can run terminal commands.

New to TrueCal? Start with the guides, compare plans on pricing, or check the FAQ before giving an agent access.

Available now

Install the npm package

Start read-only. Let your agent inspect profile, health context, targets, and meal history without giving it meal-write access.

npm install -g @truecal/cli
truecal help --json
truecal auth login --json
truecal agent enable codex --json
truecal agent doctor --profile codex --json --no-interactive

Open npm package Open app setup

Paste this into your agent

Install and configure the TrueCal CLI for this machine.

Run:
npm install -g @truecal/cli
truecal help --json
truecal auth login --json
truecal agent enable codex --json
truecal agent doctor --profile codex --json --no-interactive

Use JSON mode. Do not paste tokens into chat, project files, dotfiles, or logs. Start read-only. Only request meal-write access when I explicitly ask you to log food.

Headless or remote setup

If an agent cannot open a browser, use the device approval flow and approve the code inside TrueCal.

truecal agent enable codex --device --api-url https://app.truecal.com --json
# Approve the code at https://app.truecal.com/agent-cli/device
truecal agent doctor --profile codex --json --no-interactive

Approve a device code

When you want writes

Meal logging and connector writes are explicit. Grant write access only when you want the agent to log or manage health data.

truecal agent enable codex --scopes profile:read,health:read,meals:read,targets:read,meals:create --allow-mutate --json
truecal meals log --profile codex --allow-mutate --json --no-interactive --text "2 eggs, toast, and coffee"
truecal audit list --profile codex --json --no-interactive

ChatGPT and Claude connectors

ChatGPT app

TrueCal already has a remote MCP app path. Public availability depends on OpenAI review and listing acceptance.

Claude connector

Claude custom connectors use remote MCP over public HTTPS. TrueCal is using the same scoped auth model for read and write tools.

Credential rules

Use JSON output for agents.
Keep credentials in the CLI store.
Do not paste tokens into chat, notes, repo files, or logs.
Use audit commands after write actions.

Agent FAQ

Can I use TrueCal from my AI agent?

Yes. Install @truecal/cli, authenticate once, and tell your agent to use JSON commands. This works with terminal-capable agents today.

Can an agent write to my TrueCal log?

Yes, but only after explicit write access. Start read-only, then grant write scopes when you want meal logging or other mutations.

Are ChatGPT and Claude public connectors live?

The connector code path is based on remote MCP. Public listing depends on vendor review. Use the CLI now while those connector listings move through review.