Use Seren from agents and terminals

Authenticate

Log in and verify the active profile

Browser login is the recommended interactive path. Automation can supply SEREN_API_KEY and select a profile with --profile or SEREN_PROFILE.

seren auth login
seren auth status
seren me

First workflows

Inspect before you change anything

These commands show your current employees, skills, databases, and pending approvals before you change anything.

seren agent cloud overview
seren agent cloud approvals list --limit 20
seren agent managed-list

seren skills search browser
seren skills installed
seren agent private-models list

seren projects list
seren database list
seren branches --project-id <id> list

seren passwords vaults list
seren passwords approvals list
seren passwords audit list

Automation

Request JSON in scripts and CI

The global output flag keeps the same commands useful to humans and automation. Prefer environment credentials in CI rather than passing an API key on the command line.

An API key can use its granted capabilities but cannot create, list, or revoke API keys. Sign in as a user when administering keys, then give automation a scoped key for the publishers or operations it needs.

export SEREN_API_KEY=your_seren_api_key

seren -o json agent cloud overview
seren -o json projects list

Agent memory

Connect agent sessions to Seren Memory

Install Seren-owned lifecycle hooks for Codex or Claude Code. The CLI preserves unrelated hooks in each agent configuration.

seren memory agent install --codex
seren memory agent install --claude

seren memory agent status --codex
seren memory agent status --claude

seren memory hook status
seren memory hook flush

The agent status command reports installation state. The hook status command reports content-free delivery health. Codex also requires an explicit trust decision. After installation, open /hooks. Review the Seren commands. Then enable them.

The hooks bring reviewed private memory into new sessions and capture policy-permitted completed turns. Captured facts start unreviewed and remain private to the authenticated user inside the organization.

claude-mem migration

Build the opt-in migration command

The standard Seren CLI and MCP server do not include SQLite. Build the CLI with the claude-mem feature only when you need the one-time importer. This build includes bundled SQLite for consistent, read-only snapshots of the existing database.

cargo install --git https://github.com/serenorg/seren.git --package seren-cli --features claude-mem

Inspect the source data first. Then create a plan before any service import. Review the workspace mappings and resolve each undecided entry. Accept the plan before an import. A local rehearsal makes no service calls.

seren memory migrate claude-mem inspect --database ~/.claude-mem/claude-mem.db
seren memory migrate claude-mem rehearse --database ~/.claude-mem/claude-mem.db --output ./claude-mem-rehearsal
seren memory migrate claude-mem plan --database ~/.claude-mem/claude-mem.db --output ./claude-mem-plan.json
seren memory migrate claude-mem accept --plan ./claude-mem-plan.json

CAUTION: Protect the rehearsal output. Delete it after review. It contains transformed memory content.

seren memory migrate claude-mem run --plan ./claude-mem-plan.json
seren memory migrate claude-mem status <migration-id>
seren memory migrate claude-mem resume <migration-id>
seren memory migrate claude-mem verify <migration-id>

If you need a shorter cutover, repeat normal snapshots while claude-mem remains active. Keep Seren hooks disabled during these snapshots. Before the final catch-up, disable the claude-mem hooks. Then stop its worker. Verify the final migration. Then enable Seren hooks.

CAUTION: Use rollback only when you intend to delete imported records. Rollback permanently deletes records selected through migration provenance.

seren memory migrate claude-mem run --plan ./claude-mem-plan.json --final-catch-up --source-stopped
seren memory migrate claude-mem verify <migration-id>
seren memory migrate claude-mem rollback <migration-id> --series --yes

Rollback deletes only records attributed to the selected migration. It does not delete live hook, manual, or MCP memories. Keep the old database and migration report as a read-only archive.

MCP

Choose hosted or local MCP

Hosted MCP is the default: you sign in through the browser and never copy an API key into the assistant. Run the local server instead when you want to authenticate with an API key or keep everything, including credential unlock, on your own machine.

codex mcp add seren --url https://mcp.serendb.com/mcp
claude mcp add --scope user --transport http seren https://mcp.serendb.com/mcp

export API_KEY=your_seren_api_key
seren mcp start

# Claude CLI with the local stdio server
claude mcp add --scope user --env API_KEY=your_seren_api_key --transport stdio seren-local -- seren mcp start

Reference

Complete references

The repository references track every command group, argument, MCP mode, environment variable, and advanced security configuration next to the implementation.