Skip to content

Added GHL Conversation Archive tool. - #9

Merged
thenotoriousllama merged 1 commit into
mainfrom
ghl-conversation-archiver
Aug 21, 2026
Merged

Added GHL Conversation Archive tool.#9
thenotoriousllama merged 1 commit into
mainfrom
ghl-conversation-archiver

Conversation

@thenotoriousllama

@thenotoriousllama thenotoriousllama commented Aug 21, 2026

Copy link
Copy Markdown
Contributor

Summary by CodeRabbit

  • New Features

    • Added a Chrome extension for exporting HighLevel conversations.
    • Detects the active HighLevel account and validates access before exporting.
    • Supports resumable exports, progress tracking, pause, stop, and retry workflows.
    • Exports JSONL data, optional per-conversation JSON files, and contact details.
    • Supports conversation pagination, message retrieval, failure reporting, and output-folder selection.
    • Added light and dark themes with clear success, error, and progress states.
  • Documentation

    • Added setup instructions, export guidance, analysis examples, limitations, and privacy safeguards.

@thenotoriousllama
thenotoriousllama merged commit 4d9d9ea into main Aug 21, 2026
3 of 4 checks passed
@thenotoriousllama
thenotoriousllama deleted the ghl-conversation-archiver branch August 21, 2026 11:46
@coderabbitai

coderabbitai Bot commented Aug 21, 2026

Copy link
Copy Markdown

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 6d5f91c1-12e9-4c80-9187-fa6a833c6404

📥 Commits

Reviewing files that changed from the base of the PR and between 4609240 and 3954c73.

⛔ Files ignored due to path filters (3)
  • ghl-conversation-archive/icons/icon128.png is excluded by !**/*.png
  • ghl-conversation-archive/icons/icon16.png is excluded by !**/*.png
  • ghl-conversation-archive/icons/icon48.png is excluded by !**/*.png
📒 Files selected for processing (10)
  • ghl-conversation-archive/README.md
  • ghl-conversation-archive/agent.js
  • ghl-conversation-archive/archive.css
  • ghl-conversation-archive/archive.html
  • ghl-conversation-archive/archive.js
  • ghl-conversation-archive/conv-agent.js
  • ghl-conversation-archive/manifest.json
  • ghl-conversation-archive/popup.css
  • ghl-conversation-archive/popup.html
  • ghl-conversation-archive/popup.js

📝 Walkthrough

Walkthrough

The pull request adds a Manifest V3 Chrome extension for HighLevel conversation archives. It validates the active page, retrieves paginated conversation data, writes resumable local exports, provides archive controls and progress reporting, and documents installation and operational limits.

Changes

Conversation archive workflow

Layer / File(s) Summary
Extension entry and HighLevel probing
ghl-conversation-archive/manifest.json, ghl-conversation-archive/popup.*, ghl-conversation-archive/agent.js
The extension probes the active HighLevel page, reports location and authentication status, and opens the archive workflow when validation succeeds.
Authenticated conversation API access
ghl-conversation-archive/conv-agent.js
The API helpers retrieve conversation pages, message pages, and normalized contact data through authenticated in-page or token-based requests.
Archive execution and local output
ghl-conversation-archive/archive.*
The archive page requests permissions, selects a folder, resumes from manifests, crawls conversations, writes JSON and JSONL outputs, records failures, and reports progress.
Archive usage documentation
ghl-conversation-archive/README.md
The README documents installation, output files, pagination, authentication, PII handling, limitations, and the initial changelog.

Estimated code review effort: 4 (Complex) | ~45 minutes

Sequence Diagram(s)

sequenceDiagram
  participant Operator
  participant Popup
  participant HighLevelPage
  participant ArchivePage
  participant LocalFolder
  Operator->>Popup: Open extension
  Popup->>HighLevelPage: Run probePage()
  HighLevelPage-->>Popup: Return location and authentication status
  Popup->>ArchivePage: Open archive workflow
  ArchivePage->>HighLevelPage: Fetch conversations, messages, and contacts
  HighLevelPage-->>ArchivePage: Return paginated data
  ArchivePage->>LocalFolder: Write archive files and checkpoints
  ArchivePage-->>Operator: Show progress and completion
Loading

Suggested reviewers: legioncodeinc

Poem

I hop through HighLevel, neat and bright,
Paging conversations into the night.
JSONL streams and checkpoints grow,
Pausing safely when ears say “slow.”
With folders ready, the archive is done—
A bunny-approved export for everyone!

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch ghl-conversation-archiver

Comment @coderabbitai help to get the list of available commands.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant