AI help where the work actually happens — plus an Etsy Messages layout that uses your screen properly.
Features · Messages workspace · Install · Privacy · Architecture · Contributing
Project naming: the public project/repository brand is SellerPilot for Etsy. The current browser-extension package name in
manifest.jsonremains Etsy AI Assistant for compatibility with the existing extension/release identity.
Illustrative diagram with synthetic UI elements. SellerPilot creates reply drafts; it does not send messages automatically.
SellerPilot improves Etsy seller workflows in two ways: it adds a context-aware AI assistant directly to Etsy, and it turns the cramped Etsy Messages page into a much more practical full-height workspace. Instead of leaving most of the screen to static navigation, order chrome, blank space, and the footer, the enhanced layout lets the conversation use the available space and keeps the surrounding panels resizable.
The AI assistant can use the Etsy page you are currently viewing, listing information, conversation history, saved preferences, and supported customer images to produce more relevant answers and reply drafts.
The project is designed to stay local-first: extension state is stored in the browser, AI requests go directly to the provider configured by the user, and no developer-operated backend is required for normal AI requests.
- Full-height conversation workspace that removes the large unused footer/blank area from active chats
- Conversation column expands to use the remaining screen instead of staying in a small fixed area
- Resizable inbox/navigation and order-details panels with widths saved locally
- Auto-expanding reply composer
- Per-conversation draft persistence and sent-draft guards
- Conversation attachment gallery in the details panel with click-to-preview images
- SPA-aware behavior when moving between Etsy conversations without a full page reload
- Compatibility safeguards that avoid invasive layout rewrites when a future Etsy layout cannot be identified confidently
- Standalone no-AI edition:
userscripts/etsy-messages-workspace.user.jscan be installed through Tampermonkey without installing the full extension
- Floating AI chat available on Etsy pages
- Current page and page-type awareness
- Listing context and multi-listing discovery
- Etsy conversation context with per-conversation isolation
- Context freshness and scope guards to reduce stale or cross-chat data
- Customer reply drafting without automatic sending
- Reusable quick replies and AI-managed reply templates
- Local assistant memory for persistent seller preferences
- Custom shop-specific instructions
- Listing-aware assistance inside supported Etsy workflows
- Customer-image discovery from supported Etsy conversations
- Image analysis with bounded concurrency and caching
- Guardrails around sender role, stale context, and unavailable images
- Google Gemini support with streaming responses and fallback handling
- OpenRouter integration
- Optional DeepSeek and Grok provider paths
- Custom OpenAI-compatible endpoint support
- User-provided credentials only — no API keys are shipped with the project
- Chrome / Chromium
- Microsoft Edge
- Firefox build generation from the same source manifest
flowchart LR
Etsy[Etsy page] --> CS[Content scripts]
CS --> Context[Context + scope managers]
Context --> UI[SellerPilot UI]
Context --> Storage[(Browser local storage)]
UI --> AI[Configured AI provider]
Storage --> Context
AI --> UI
The extension uses content scripts to observe the current Etsy context, stores user settings and local working state in browser extension storage, and sends only the context required for an enabled AI feature to the provider selected by the user.
For the detailed component map and trust boundaries, see ARCHITECTURE.md.
SellerPilot does not include API keys, Etsy account credentials, customer exports, or a developer-operated analytics service.
Locally stored data can include:
- provider API credentials
- assistant preferences and custom instructions
- local memory and quick replies
- chat history used by the extension
- cached Etsy page, listing, and conversation context
- derived image-analysis metadata
The extension does not add its own encryption layer around browser local storage.
When an AI feature needs Etsy context, relevant page, listing, conversation, or image data may be sent directly to the selected provider. A custom OpenAI-compatible provider receives data at the endpoint configured by the user.
Read the full Privacy Policy before using the extension with real seller/customer data.
- Clone or download this repository.
- Open
chrome://extensions/oredge://extensions/. - Enable Developer mode.
- Choose Load unpacked.
- Select the
src/directory. - Open extension settings and configure your own AI provider credentials.
If you only want the Etsy Messages layout/workflow improvements, install the standalone userscript instead of the full extension:
userscripts/etsy-messages-workspace.user.js
It includes the full-height Messages layout, resizable side panels, local drafts, attachment gallery, and image preview without any AI-provider setup. See userscripts/README.md for installation and privacy details.
On Windows, run:
build.batThen open about:debugging#/runtime/this-firefox and load:
dist/firefox/manifest.json
The build also creates a Firefox XPI for normal signing/release workflows.
src/manifest.json is the single source of truth for the browser manifest.
build.batGenerated output:
dist/chrome/ Chromium package contents
dist/firefox/ Firefox package contents
dist/*.xpi Packaged Firefox development build
See BUILD_INSTRUCTIONS.md for more detail.
src/
├── background/ background service worker and privileged operations
├── common/ shared browser helpers
├── config/ assistant policy and compatibility data
├── content/ Etsy integration, context, AI providers, UI and guards
├── libs/ vendored browser-side libraries
├── offscreen/ Chromium offscreen parsing support
└── options/ extension settings UI
userscripts/ standalone no-AI Etsy Messages workspace for Tampermonkey
tests/ automated tests and synthetic fixtures
.github/ repository and release automation metadata
The project intentionally treats Etsy/customer content and provider credentials as sensitive data.
- Never commit API keys, browser cookies, Etsy exports, customer conversations, private screenshots, or browser profiles.
- Tests and public examples must use synthetic data.
- Store-release credentials belong in GitHub Actions secrets.
- Custom AI endpoints require optional host access because their hostname is chosen by the user at runtime.
- Generated customer replies are drafts and should be reviewed before sending.
For vulnerability reporting and credential-exposure guidance, see SECURITY.md.
There is no required application backend and no package-install step for the core extension source.
Typical development loop:
- edit files under
src/ - reload the unpacked extension in the browser
- run the relevant tests
- use
build.batwhen a packaged cross-browser build is needed
Contributor and AI-agent guidance lives in CONTRIBUTING.md and AGENTS.md.
Issues, bug reports, focused improvements, and pull requests are welcome.
Before contributing:
- read CONTRIBUTING.md
- use synthetic/redacted examples
- keep security and conversation-isolation boundaries intact
- do not trigger store-release workflows unless a maintainer explicitly intends a release
| Document | Purpose |
|---|---|
| CHANGELOG.md | Source-level release history |
| ARCHITECTURE.md | Components, data flow, trust boundaries |
| COMPATIBILITY.md | Etsy UI compatibility layer and degraded-mode behavior |
| userscripts/README.md | Standalone Tampermonkey Messages workspace |
| BUILD_INSTRUCTIONS.md | Local Chrome/Edge/Firefox build process |
| PRIVACY_POLICY.md | Data collection, storage, and provider disclosure |
| SECURITY.md | Security reporting and credential guidance |
| CONTRIBUTING.md | Contribution rules |
| AGENTS.md | Repository guidance for coding agents |
| THIRD_PARTY_NOTICES.md | Vendored dependency attribution |
Public contributions are especially useful around:
- broader browser compatibility
- stronger automated test coverage
- Etsy UI-change resilience
- permission minimization
- accessibility and keyboard navigation
- privacy-preserving diagnostics
SellerPilot for Etsy is an independent open-source project. It is not affiliated with, endorsed by, or sponsored by Etsy, Inc. Etsy pages and internal APIs can change without notice and may break integration behavior.
Released under the MIT License.
Vendored third-party code keeps its original upstream licensing and attribution; see THIRD_PARTY_NOTICES.md.