@lightupai/polaris 0.0.67 → 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 +87 -39
  2. package/package.json +1 -1
package/docs/seo-geo.md CHANGED
@@ -23,13 +23,9 @@
23
23
  - [x] **Page titles** — dashboard ("Dashboard — Polaris"), setup ("Setup — Polaris"), profile ("Polaris - Profile")
24
24
  - [x] **Alt text on images** — added to all img tags on the landing page
25
25
 
26
- ## SEO — To Do
27
-
28
- ### High Priority
26
+ - [x] **Google Search Console** — property verified via DNS TXT record, sitemap submitted
29
27
 
30
- - [ ] **Submit sitemap to Google Search Console**
31
- Register `app.withpolaris.ai` at https://search.google.com/search-console.
32
- Verify ownership via Cloudflare DNS TXT record. Submit sitemap URL.
28
+ ## SEO — To Do
33
29
 
34
30
  - [ ] **Blog / content marketing**
35
31
  Long-tail SEO needs content pages targeting search terms:
@@ -40,64 +36,116 @@
40
36
  - "Gong for AI coding"
41
37
  Options: simple `/blog` route with markdown rendering, or a subdomain `blog.withpolaris.ai`.
42
38
 
43
- ## 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.
44
47
 
45
48
  ### High Priority
46
49
 
47
- - [ ] **Enable Cloudflare proxy (orange cloud)**
48
- DNS records for `app.withpolaris.ai` and `api.withpolaris.ai` are
49
- likely DNS-only (gray cloud). Switching to proxied gives:
50
- - Free global CDN (faster loads worldwide)
51
- - Automatic caching of static assets
52
- - DDoS protection
53
- - Web Application Firewall
54
- Note: Caddy handles HTTPS on the server. Enabling Cloudflare proxy
55
- means Cloudflare terminates TLS and connects to Caddy. Need to set
56
- Cloudflare SSL mode to "Full (strict)" and ensure Caddy's certs
57
- 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.
58
73
 
59
74
  ### Medium Priority
60
75
 
61
- - [ ] **Check server location**
62
- Verify where the Hetzner VPS is located (likely EU — Finland or Germany).
63
- If most users are US-based, consider:
64
- - Migrating to a US Hetzner datacenter (Ashburn, VA)
65
- - 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.
66
81
 
67
- - [ ] **Cache headers for static assets**
68
- OG image has 24h cache. CSS has immutable 1yr cache. Landing page HTML
69
- has `Cache-Control: no-store` — consider short cache (5-10 min) since
70
- it changes infrequently.
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`.
71
88
 
72
- ### Low Priority
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.
73
92
 
74
- - [ ] **Content localization**
75
- Not needed yet. English only. Revisit if expanding to non-English markets.
93
+ - [ ] **Product Hunt launch**
94
+ Creates a high-authority page that LLMs cite. Time it with a
95
+ feature milestone.
76
96
 
77
- - [ ] **CDN for the npm package**
78
- The CLI is published to npm. npm CDN (unpkg, jsdelivr) handles global
79
- distribution automatically. No action needed.
97
+ ### Low Priority
98
+
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 |
80
126
 
81
127
  ## Target Keywords
82
128
 
83
- Primary:
129
+ Primary (match LLM fan-out queries):
84
130
  - "AI coding session recording"
85
- - "Claude Code collaboration"
86
- - "AI agent observability"
87
- - "Slack integration for AI coding"
131
+ - "Claude Code session recording"
88
132
  - "Gong for AI coding"
133
+ - "Claude Code collaboration"
134
+ - "AI coding session tools"
89
135
 
90
136
  Secondary:
91
137
  - "AI session capture tool"
92
138
  - "multiplayer AI coding"
93
- - "AI coding agent memory"
94
- - "context graph for AI agents"
139
+ - "Slack integration for AI coding"
140
+ - "AI agent observability"
95
141
  - "engineering knowledge capture AI"
96
142
 
97
143
  ## Useful Links
98
144
 
99
145
  - Google Search Console: https://search.google.com/search-console
146
+ - Google Analytics: https://analytics.google.com (property 542281886)
100
147
  - OG image tester: https://www.opengraph.xyz/
101
148
  - Twitter card validator: https://cards-dev.twitter.com/validator
102
149
  - PageSpeed Insights: https://pagespeed.web.dev/
103
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.67",
3
+ "version": "0.0.69",
4
4
  "type": "module",
5
5
  "bin": {
6
6
  "polaris": "bin/polaris",