Guide
Guide
Loading this Timeline guide.
Guide
Loading this Timeline guide.
Install one general Timeline skill that teaches your agent how to retrieve, verify, and cite team-visible workspace evidence.
One bundle adds the Timeline skill and hosted MCP connection. Paste the prompt into Codex and let it handle the install.
Install The Timeline plugin for this Codex environment.
Run these commands:
codex plugin marketplace add timborovkov/the-timeline-ai \
--ref main \
--sparse .agents/plugins \
--sparse plugins/timeline
codex plugin add timeline@timeline
Then verify that the timeline skill is installed.
Check only whether TIMELINE_MCP_KEY is present; do not print, echo, log, or inspect its value. If it is unavailable, stop and explain that a Timeline team admin must create it at https://thetimeline.cc/app/team/mcp-share because its plaintext is shown only once. Tell CLI users to set it in the terminal that will launch Codex, fully exit the current Codex process, and relaunch codex from that same terminal. Tell Codex app and IDE users to store TIMELINE_MCP_KEY=<one-time key> in ~/.codex/.env, outside any repository, restrict that file to their user account, and fully restart the app or extension. A new task alone cannot import an environment variable added after Codex started.
Never ask me to paste the key into chat or write it to a repository file.
When setup and the launch environment are ready, tell me to start a new task so Codex loads the plugin.Install only the skill, or connect the MCP endpoint without the plugin.
Best for self-hosted Timeline or agents that already have an MCP connection.
$skill-installer Install this Timeline skill from GitHub:
- https://github.com/timborovkov/the-timeline-ai/tree/main/plugins/timeline/skills/timelineSet TIMELINE_MCP_KEY in the terminal that will launch Codex, run the command, then relaunch Codex from that terminal.
codex mcp add timeline \
--url "https://thetimeline.cc/api/mcp/server" \
--bearer-token-env-var TIMELINE_MCP_KEYThree steps
Codex adds the sparse repository marketplace, installs the plugin, and checks the bundled Timeline skill.
A Timeline admin creates a one-time key. Export it in the CLI launch terminal, or store it as TIMELINE_MCP_KEY in ~/.codex/.env for the app or IDE.
If you just added the key, fully relaunch Codex from the environment that contains it. A new task then discovers the plugin skill and MCP tools.
The Timeline skill routes each request to the relevant MCP tools, expands material source records, and preserves citations, uncertainty, and visibility boundaries.
timelineChoose the right Timeline MCP tools, expand source evidence, distinguish current state from activity, and cite consequential claims.
View skillThe install path and access boundary are intentionally separate.