Merge pull request #14 from opensource-observer/home-fixes

home fixes

Author: ccerv1

app/app/page.tsx

@@ -83,8 +83,8 @@ export default function Home() {
             Unified data from{' '}
             <a href="https://opendevdata.org/" target="_blank" rel="noopener noreferrer" className="text-gray-800 underline underline-offset-2 decoration-gray-300 hover:decoration-gray-600 transition-colors">Open Dev Data</a>,{' '}
             <a href="https://www.gharchive.org/" target="_blank" rel="noopener noreferrer" className="text-gray-800 underline underline-offset-2 decoration-gray-300 hover:decoration-gray-600 transition-colors">GitHub Archive</a>, and{' '}
-            <a href="https://www.oso.xyz" target="_blank" rel="noopener noreferrer" className="text-gray-800 underline underline-offset-2 decoration-gray-300 hover:decoration-gray-600 transition-colors">OSO</a>{' '}
-            — explore it in the browser, query it via API, or hand it to your AI agent.
+            <a href="https://www.oso.xyz" target="_blank" rel="noopener noreferrer" className="text-gray-800 underline underline-offset-2 decoration-gray-300 hover:decoration-gray-600 transition-colors">OSO</a>.
+            Explore it in the browser, query via a single API, or just hand it to your agent.
           </p>
         </div>
 
@@ -96,15 +96,17 @@ export default function Home() {
               <h2 className="text-sm font-semibold text-gray-900 mb-1.5">Stop plumbing. Start visualizing.</h2>
               <p className="text-gray-500 text-sm leading-relaxed">
                 Cross-source data pipelines are hard to build and harder to maintain.
-                DDP handles the integration so you can go straight to insights.
+                DDP handles the messy middle so you can go straight to doing cool things.
               </p>
             </div>
             <div>
               <h2 className="text-sm font-semibold text-gray-900 mb-1.5">Open. Traceable. Forkable.</h2>
               <p className="text-gray-500 text-sm leading-relaxed">
-                Every model is a Python notebook — built on{' '}
+                Every page you see here is a Python notebook — built on{' '}
                 <a href="https://marimo.io/" target="_blank" rel="noopener noreferrer" className="text-gray-700 underline underline-offset-2 decoration-gray-300 hover:decoration-gray-600 transition-colors">marimo</a>
-                {' '}— that you can inspect, replicate, or fork and run in your own environment.
+                {' '}— that you can inspect, replicate, or{' '}
+                <a href="https://github.com/opensource-observer/ddp" target="_blank" rel="noopener noreferrer" className="text-gray-700 underline underline-offset-2 decoration-gray-300 hover:decoration-gray-600 transition-colors">fork</a>
+                {' '}and run in your own environment.
               </p>
             </div>
           </div>

app/public/agents.md

@@ -79,7 +79,9 @@ GROUP BY e.name ORDER BY active_devs DESC LIMIT 10
 ```
 
 ## Important Notes
+- **Only `oso.*` tables are publicly accessible.** Tables with other namespaces (e.g., `ethereum.*`) require customer-scoped API keys and will return an error with a standard key.
 - GitHub Archive data can be ~3 days behind real-time
 - Only public GitHub events (no private repos)
+- When listing/ranking ecosystems, add `WHERE e.is_crypto = 1 AND e.is_category = 0` to filter out internal ODD categories
 - Use narrow date ranges (7-30 days) for fast queries
 - Full data catalog: https://docs.oso.xyz

notebooks/agent-guide.py

@@ -24,7 +24,7 @@ def _(mo):
     curl -s {_url}
     ```
 
-    The guide is a standalone markdown file with connection setup, SQL dialect, key tables, and starter queries. Paste it into Claude, ChatGPT, or any agent framework — your agent will self-configure and start querying.
+    The guide is a standalone markdown file with connection setup, SQL dialect, key tables, and starter queries. Paste it into Claude Code, Codex, or any agent framework. Your agent will ask you for an API key and start querying.
     """)
     return
 
@@ -299,8 +299,8 @@ def _(mo):
         "```\n"
     )
     mo.vstack([
-        mo.md("## Create an Interactive Notebook"),
-        mo.md("Skill template for creating new notebooks using DDP data with marimo. Copy the guide below. Point your agent to existing notebooks we've created for inspiration."),
+        mo.md("## Creating Interactive Notebooks"),
+        mo.md("We also have some skill templates for creating notebooks on top of DDP data with marimo. The guides below are opinionated but hopefully useful as inspiration. You can also point your agent to the [full repo](https://github.com/opensource-observer/ddp)."),
         mo.accordion({
             "Notebook Creation Guide": mo.md(f"~~~markdown\n{_guide}\n~~~"),
             "Advanced Patterns": mo.md(f"~~~markdown\n{_advanced_guide}\n~~~"),