Skip to content

[codex] Fix product guide storage paths #238

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
0xmrpeter merged 1 commit into from
Apr 25, 2026
Merged

[codex] Fix product guide storage paths #238

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 15 additions & 14 deletions src/data/product-guide.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -314,7 +314,7 @@ Example: after starting a dev server on port 3000, run \`openacp tunnel add 3000

## Configuration

Config file: \`~/.openacp/config.json\`
Config file: \`<workspace>/.openacp/config.json\` (default: \`~/openacp-workspace/.openacp/config.json\`)

### Channels
- **channels.telegram.botToken** — Your Telegram bot token
Expand All @@ -325,7 +325,7 @@ Config file: \`~/.openacp/config.json\`
### Agents
- **defaultAgent** — Which agent to use by default
- Agents are managed via \`/agents\` (Telegram) or \`openacp agents\` (CLI)
- Installed agents are stored in \`~/.openacp/agents.json\`
- Installed agent definitions are stored in \`<instance-root>/agents.json\`; downloaded agent binaries live in \`~/.openacp/agents/\`
- Agent list is fetched from the ACP Registry CDN and cached locally (24h)

### Workspace
Expand All @@ -346,7 +346,7 @@ Config file: \`~/.openacp/config.json\`

### Logging
- **logging.level** — Log level: silent, debug, info, warn, error, fatal (default: info)
- **logging.logDir** — Log directory (default: \`~/.openacp/logs\`)
- **logging.logDir** — Log directory (default: \`<instance-root>/logs\`)
- **logging.maxFileSize** — Max log file size before rotation
- **logging.maxFiles** — Max number of rotated log files
- **logging.sessionLogRetentionDays** — Auto-delete old session logs (default: 30)
Expand Down Expand Up @@ -404,24 +404,25 @@ Override config with env vars:
- If you see messages appearing in the Assistant topic instead of the session topic, try creating a new session

### Viewing logs
- Session-specific logs: \`~/.openacp/logs/sessions/\`
- Session-specific logs: \`<instance-root>/logs/sessions/\`
- System logs: \`openacp logs\` to tail live
- Set \`OPENACP_DEBUG=true\` for verbose output

---

## Data & Storage

All data is stored in \`~/.openacp/\`:
- \`config.json\` — Configuration
- \`agents.json\` — Installed agents (managed by AgentCatalog)
- \`registry-cache.json\` — Cached ACP Registry data (refreshes every 24h)
- \`agents/\` — Downloaded binary agents
- \`sessions/\` — Session records and state
- \`topics/\` — Topic-to-session mappings
- \`logs/\` — System and session logs
- \`plugins/\` — Installed adapter plugins
- \`openacp.pid\` — Daemon PID file
OpenACP stores per-instance state in \`<workspace>/.openacp/\` (the instance root), with shared downloads and caches under \`~/.openacp/\`:
- \`<instance-root>/config.json\` — Configuration
- \`<instance-root>/agents.json\` — Installed agent definitions (managed by AgentCatalog)
- \`<instance-root>/sessions.json\` — Session records and state
- \`<instance-root>/usage.json\` — Token and cost tracking
- \`<instance-root>/history/\` — Per-session conversation history
- \`<instance-root>/logs/\` — System and session logs
- \`<instance-root>/plugins/\` — Installed adapter plugins and plugin data
- \`<instance-root>/openacp.pid\` — Daemon PID file
- \`~/.openacp/cache/registry-cache.json\` — Cached ACP Registry data (refreshes every 24h)
- \`~/.openacp/agents/\` — Downloaded binary agents

Session records auto-cleanup: 30 days (configurable via \`sessionStore.ttlDays\`).
Session logs auto-cleanup: 30 days (configurable via \`logging.sessionLogRetentionDays\`).
Expand Down