@lightupai/polaris 0.0.68 → 0.0.69

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/docs/seo-geo.md +85 -33
  2. package/package.json +1 -1
package/docs/seo-geo.md CHANGED
@@ -36,64 +36,116 @@
36
36
  - "Gong for AI coding"
37
37
  Options: simple `/blog` route with markdown rendering, or a subdomain `blog.withpolaris.ai`.
38
38
 
39
- ## Geo — To Do
39
+ ## GEO — To Do
40
+
41
+ Generative Engine Optimization — getting Polaris cited by LLMs (ChatGPT,
42
+ Perplexity, Gemini, Claude) when users ask about AI coding session tools.
43
+
44
+ **Baseline (2026-06-18):** Polaris is mentioned by 0/3 major LLMs for
45
+ "Gong for AI coding" queries. Competitors cited: AgentReplay, vibe-replay,
46
+ Longhouse, SessionForge, CC Replay, Blackcrab, Mantra, Nokos.
40
47
 
41
48
  ### High Priority
42
49
 
43
- - [ ] **Enable Cloudflare proxy (orange cloud)**
44
- DNS records for `app.withpolaris.ai` and `api.withpolaris.ai` are
45
- likely DNS-only (gray cloud). Switching to proxied gives:
46
- - Free global CDN (faster loads worldwide)
47
- - Automatic caching of static assets
48
- - DDoS protection
49
- - Web Application Firewall
50
- Note: Caddy handles HTTPS on the server. Enabling Cloudflare proxy
51
- means Cloudflare terminates TLS and connects to Caddy. Need to set
52
- Cloudflare SSL mode to "Full (strict)" and ensure Caddy's certs
53
- are valid. Test carefully.
50
+ - [ ] **GitHub README as the canonical source**
51
+ LLMs scrape GitHub heavily. The README needs to lead with the exact
52
+ phrases LLMs search for: "AI coding session recording", "Gong for
53
+ AI coding", "Claude Code session recording". Currently the README
54
+ leads with architecture — rewrite the intro to match search intent.
55
+
56
+ - [ ] **npm package description**
57
+ `npm view @lightupai/polaris` — the package description and keywords
58
+ are what LLMs see. Update with target phrases: "Record and stream
59
+ Claude Code sessions to Slack. Like Gong for AI coding."
60
+
61
+ - [ ] **Comparison / "alternatives" blog post**
62
+ LLMs heavily cite comparison pages. Write a post like "Polaris vs
63
+ AgentReplay vs SessionForge — AI coding session tools compared"
64
+ that positions Polaris and links to withpolaris.ai. Publish on the
65
+ blog and cross-post to dev.to / Medium.
66
+
67
+ - [ ] **Reddit / Hacker News / community presence**
68
+ LLMs cite Reddit and HN threads. Post in:
69
+ - r/ClaudeAI (GPT-5.5 already cites a Claude Code replay post there)
70
+ - r/ChatGPTPro, r/LocalLLaMA, r/ExperiencedDevs
71
+ - Hacker News Show HN
72
+ Include link to withpolaris.ai in posts/comments.
54
73
 
55
74
  ### Medium Priority
56
75
 
57
- - [ ] **Check server location**
58
- Verify where the Hetzner VPS is located (likely EU — Finland or Germany).
59
- If most users are US-based, consider:
60
- - Migrating to a US Hetzner datacenter (Ashburn, VA)
61
- - Or relying on Cloudflare proxy to cache static content at edge
76
+ - [ ] **Landing page copy matches LLM fan-out queries**
77
+ GPT-5.5 searches for: "Claude Code session recording sharing tools",
78
+ "AI coding session recording tool Claude Code terminal replay",
79
+ "Claude Code observability session recordings tool". Ensure the
80
+ landing page H1/H2/description contain these phrases naturally.
81
+
82
+ - [ ] **Dev blog with target keyword articles**
83
+ Write content targeting the exact queries LLMs use:
84
+ - "How to record Claude Code sessions"
85
+ - "AI coding session recording for teams"
86
+ - "Multiplayer AI coding with Slack"
87
+ Options: `/blog` route with markdown, or subdomain `blog.withpolaris.ai`.
62
88
 
63
- - [ ] **Cache headers for static assets**
64
- OG image has 24h cache. CSS has immutable 1yr cache. Landing page HTML
65
- has `Cache-Control: no-store` — consider short cache (5-10 min) since
66
- it changes infrequently.
89
+ - [ ] **GitHub Discussions / Issues as citable content**
90
+ LLMs scrape GitHub discussions. Active Q&A in Discussions creates
91
+ citable pages linking back to Polaris. Seed with FAQs and how-tos.
67
92
 
68
- ### Low Priority
93
+ - [ ] **Product Hunt launch**
94
+ Creates a high-authority page that LLMs cite. Time it with a
95
+ feature milestone.
69
96
 
70
- - [ ] **Content localization**
71
- Not needed yet. English only. Revisit if expanding to non-English markets.
97
+ ### Low Priority
72
98
 
73
- - [ ] **CDN for the npm package**
74
- The CLI is published to npm. npm CDN (unpkg, jsdelivr) handles global
75
- distribution automatically. No action needed.
99
+ - [ ] **Structured data for LLM parsing**
100
+ Add `llms.txt` or `llms-full.txt` to the site root — an emerging
101
+ convention for telling LLMs about your product in a machine-friendly
102
+ format. See llmstxt.org.
103
+
104
+ - [ ] **Monitor GEO position over time**
105
+ Set up periodic DataForSEO `ai_optimization_llm_response` queries
106
+ for target keywords across ChatGPT/Perplexity/Gemini. Track whether
107
+ Polaris starts appearing in responses. Requires DFS subscription
108
+ for `ai_opt_llm_ment_search`.
109
+
110
+ ## GEO — Competitors
111
+
112
+ Tools cited by LLMs for "Gong for AI coding" (as of 2026-06-18):
113
+
114
+ | Tool | Cited by | Positioning |
115
+ |---|---|---|
116
+ | AgentReplay | ChatGPT | "Loom for your AI coding agent" |
117
+ | vibe-replay | ChatGPT | Analytics + replay across tools |
118
+ | Longhouse | ChatGPT | Mission control for AI coding sessions |
119
+ | SessionForge | ChatGPT | Team visibility / RBAC / remote sessions |
120
+ | CC Replay | ChatGPT | Claude Code-specific local replay |
121
+ | Blackcrab | ChatGPT | Claude Code GUI |
122
+ | Multiplayer.app | Perplexity | AI dev workflow capture |
123
+ | Mantra | Gemini | Unified AI session manager |
124
+ | Nokos | Gemini | Cross-tool conversation capture |
125
+ | claude-devtools | Gemini | JSONL transcript viewer |
76
126
 
77
127
  ## Target Keywords
78
128
 
79
- Primary:
129
+ Primary (match LLM fan-out queries):
80
130
  - "AI coding session recording"
81
- - "Claude Code collaboration"
82
- - "AI agent observability"
83
- - "Slack integration for AI coding"
131
+ - "Claude Code session recording"
84
132
  - "Gong for AI coding"
133
+ - "Claude Code collaboration"
134
+ - "AI coding session tools"
85
135
 
86
136
  Secondary:
87
137
  - "AI session capture tool"
88
138
  - "multiplayer AI coding"
89
- - "AI coding agent memory"
90
- - "context graph for AI agents"
139
+ - "Slack integration for AI coding"
140
+ - "AI agent observability"
91
141
  - "engineering knowledge capture AI"
92
142
 
93
143
  ## Useful Links
94
144
 
95
145
  - Google Search Console: https://search.google.com/search-console
146
+ - Google Analytics: https://analytics.google.com (property 542281886)
96
147
  - OG image tester: https://www.opengraph.xyz/
97
148
  - Twitter card validator: https://cards-dev.twitter.com/validator
98
149
  - PageSpeed Insights: https://pagespeed.web.dev/
99
150
  - Cloudflare dashboard: https://dash.cloudflare.com/
151
+ - DataForSEO: https://app.dataforseo.com/
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lightupai/polaris",
3
- "version": "0.0.68",
3
+ "version": "0.0.69",
4
4
  "type": "module",
5
5
  "bin": {
6
6
  "polaris": "bin/polaris",