Troubleshooting

Symptom: startup/runtime reports Missing env var ....

Fix:

• Ensure required env var is exported (DEEPSEEK_API_KEY / OPENAI_API_KEY).
• Ensure env_api_key in config.toml matches the actual env var you use (see Configuration).

Cause: one-shot mode usually cannot run interactive approvals, so write/exec tools are denied by default.

Fix:

• Use TUI mode: memo
• Or, if risk is controlled, use: memo --dangerous --once
• Or convert task to read-only/advisory mode (no file writes, no command execution)

Cause: grep tool depends on system ripgrep (rg).

Fix:

• Install ripgrep (macOS: brew install ripgrep)
• Or use alternatives (for example, narrow with glob first, then read targeted files)

Suggestions:

• Check network and proxy settings
• Verify base_url is correct (see Configuration)
• Retry and reduce request/page size (webfetch has timeout and size limits)

Fix:

• Run memo mcp list to verify config is saved
• Use /mcp in TUI to verify what the current session actually loaded
• After config changes, restart memo or start a new session (see MCP Extensions)

Fix:

• Lower limit with /context or start a new session with /new
• Split the task: summarize key points first, then process in chunks