uv run --python 3.12 python "$ATLAS_CLI" app-name uv run --python 3.12 python "$ATLAS_CLI" tabs --json


The CLI requires the Atlas app bundle in `/Applications` or `~/Applications`:

- `ChatGPT Atlas`

If AppleScript fails with a permissions error, grant Automation permission in
System Settings > Privacy & Security > Automation, allowing your terminal to
control ChatGPT Atlas.

## Tabs Workflow

1. List tabs to get `window_id` and `tab_index`:

```bash
uv run --python 3.12 python "$ATLAS_CLI" tabs

Focus a tab using the window_id and tab_index from the listing:

uv run --python 3.12 python "$ATLAS_CLI" focus-tab <window_id> <tab_index>

Open a new tab:

uv run --python 3.12 python "$ATLAS_CLI" open-tab "https://chatgpt.com/"

Optional maintenance commands:

uv run --python 3.12 python "$ATLAS_CLI" reload-tab <window_id> <tab_index>
uv run --python 3.12 python "$ATLAS_CLI" close-tab <window_id> <tab_index>

Bookmarks and History

Atlas stores Chromium-style profile data under ~/Library/Application Support/com.openai.atlas/browser-data/host/.

List bookmarks:

uv run --python 3.12 python "$ATLAS_CLI" bookmarks --limit 100

Search bookmarks:

uv run --python 3.12 python "$ATLAS_CLI" bookmarks --search "docs"

Search history:

uv run --python 3.12 python "$ATLAS_CLI" history --search "openai docs" --limit 50

History for today (local time):

uv run --python 3.12 python "$ATLAS_CLI" history --today --limit 200 --json

The history command copies the SQLite database to a temporary location to avoid lock errors.

If history looks stale or empty, ask the user which Atlas install they are using, then check both Atlas data roots and inspect the one with the most recent History file:

~/Library/Application Support/com.openai.atlas/browser-data/host/
~/Library/Application Support/com.openai.atlas.beta/browser-data/host/

References

Read references/atlas-data.md in the skill folder (for example, $CODEX_HOME/skills/atlas/references/atlas-data.md) when adjusting data paths or timestamps.

atlas

Atlas Control (macOS)

Quick Start

More from clementwalter/claudine

scaleway deployment

playwright

pdf

share

test

slack-user-cli