Account

Commands for managing your Recalletta account, API keys, and settings.

First-Time Setup

$ recalletta init [USERNAME] [PASSWORD]

Interactive first-time setup. Checks local client integration, attempts to authenticate (login) and save your API key to ~/.recalletta/config.json, and installs/enables hooks when a supported client is detected.

If you pass username and password as arguments, it skips the interactive prompts.

Note: init does not create an account. If you need a new account, use recalletta register.

$ recalletta login [USERNAME] [PASSWORD]

Authenticates with the API and saves your API key locally. If arguments are omitted, prompts interactively.

Register

$ recalletta register [USERNAME] [PASSWORD] [EMAIL] [COMPANY]

Creates a new account. If arguments are omitted, prompts interactively.

Note: Do not run register or login without arguments in non-interactive environments (scripts, hooks) — they will hang waiting for input.

Confirm Email

$ recalletta confirm-email

Confirms your email address with a token.

Show Current User

$ recalletta auth
Username: atlas
Name: atlas
Email: atlas@example.com
API Keys: 3

Some personal information has been redacted for security and ethical considerations.

API Keys

$ recalletta keys                  # List all keys
$ recalletta keys create [NAME]    # Create a new key
$ recalletta keys revoke <ID>      # Revoke a key

API keys are stored as SHA256 hashes server-side. The plaintext key is shown once on creation — save it.

Settings

$ recalletta settings              # Show all settings
$ recalletta settings KEY=VALUE    # Set a value
$ recalletta settings KEY          # Get a value

Real output:

$ recalletta settings
=== API Settings ===
min_conversation_length: 50
auto_generate_tags: true
auto_generate_summaries: true
max_context_results: 10

=== CLI Settings ===
inject_summary: false
debug: false
auto_index_on_session_end: false

=== KB Auto-Update Settings ===
Auto-update mode: AUTO (default)
  Context: personal workspace

Key Settings

Setting	Default	Purpose
`inject_summary`	`false`	Include session summaries in SessionStart context injection
`debug`	`false`	Enable debug logging for CLI operations
`auto_index_on_session_end`	`false`	Automatically run incremental `repo index` on session end
`auto_generate_tags`	`true`	API auto-generates tags for uploaded sessions
`auto_generate_summaries`	`true`	API auto-generates summaries for uploaded sessions
`max_context_results`	`10`	Max sessions returned by SessionStart context injection
`min_conversation_length`	`50`	Minimum transcript length (chars) to save a session

Configuration File

The config file lives at ~/.recalletta/config.json. It stores:

api_url -- API endpoint (default: https://api.recalletta.ai/v1)
api_key -- the API key

Treat this file like a password. Do not commit it to git.