Repository navigation
docs: Show agentop import to new users #1927
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.
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
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -434,6 +434,22 @@ Worth knowing for anyone changing this: `tool-prune` and `inference-parser` keep | |
| **separate** suffix lists, and only the parser's recognises `/responses`. The drift is | ||
| silent — the parser reads a Responses request that the pruner skips as "not inference". | ||
|
|
||
| ## Import history | ||
|
|
||
| `agentop import --agent codex` adds the Codex sessions from before Cortex to the | ||
| session history and the cost ledger. It reads the rollout files under | ||
| `~/.codex/sessions`, or under `$CODEX_HOME/sessions` when that variable is set | ||
| in the proxy's environment. | ||
|
Collaborator
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. nit:
Comment on lines
+439
to
+442
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Document the archived-session limitation. Codex sessions stored in
|
||
|
|
||
| - The root rollout of a session and the rollouts of its subagents make one | ||
| session. | ||
| - The import skips a session that Cortex captured live. | ||
| - A turn is priced at today's rates. | ||
|
|
||
| Flags and output: | ||
| [`agentop import`](../../cmd/agentop/README.md#importing-agent-history-agentop-import). | ||
| Rules: [`POST /v1/import`](../session-api.md#post-v1import--transcript-import-laptop-only). | ||
|
|
||
| ## Verified depth | ||
|
|
||
| Tested live with Codex 0.160.1 on macOS 26.3 (arm64), against the real ChatGPT backend, | ||
|
|
||
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Explain the default retention limit.
Sessions last updated more than 30 days ago are skipped on a default install. Their cost is not imported either. The linked guide does not explain how to change this limit. Note the limit and link to the archive and cost-ledger retention settings for users who need older history. (raw.githubusercontent.com)