feat: add custom domain clarissa.run and bump to v1.0.1

cameronrye · cameronrye · commit f7df69f91595 · 2025-12-07T17:49:37.000-05:00
- Update astro.config.mjs with new site URL
- Add CNAME file for GitHub Pages custom domain
- Add Open Graph and Twitter Card meta tags
- Add JSON-LD structured data for SEO
- Bump version to 1.0.1 in package.json files
diff --git a/README.md b/README.md
@@ -138,19 +138,51 @@ mv clarissa-macos-arm64 /usr/local/bin/clarissa
 
 ## Configuration
 
-Set your OpenRouter API key as an environment variable:
+Create a config file at `~/.clarissa/config.json`:
+
+```bash
+mkdir -p ~/.clarissa
+echo '{"apiKey": "your_api_key_here"}' > ~/.clarissa/config.json
+```
+
+Or set your OpenRouter API key as an environment variable:
 
 ```bash
 export OPENROUTER_API_KEY=your_api_key_here
 ```
 
-Optional environment variables:
+Optional settings (in config.json or as environment variables):
+
+| Config Key | Env Variable | Default | Description |
+|------------|--------------|---------|-------------|
+| `apiKey` | `OPENROUTER_API_KEY` | (required) | Your OpenRouter API key |
+| `model` | `OPENROUTER_MODEL` | `anthropic/claude-sonnet-4` | Default model to use |
+| `maxIterations` | `MAX_ITERATIONS` | `10` | Maximum tool execution iterations |
+| `debug` | `DEBUG` | `false` | Enable debug logging |
+| `mcpServers` | - | `{}` | MCP servers to auto-load (see below) |
+
+### MCP Server Configuration
+
+Add MCP servers to your config file to auto-load them on startup:
+
+```json
+{
+  "apiKey": "your_api_key_here",
+  "mcpServers": {
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
+    },
+    "github": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-github"],
+      "env": { "GITHUB_TOKEN": "your_token" }
+    }
+  }
+}
+```
 
-| Variable | Default | Description |
-|----------|---------|-------------|
-| `OPENROUTER_MODEL` | `anthropic/claude-sonnet-4` | Default model to use |
-| `MAX_ITERATIONS` | `10` | Maximum tool execution iterations per request |
-| `DEBUG` | `false` | Enable debug logging |
+Use `/mcp` to view connected servers and `/tools` to see available tools.
 
 ## Usage
 
diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs
@@ -1,8 +1,7 @@
 import { defineConfig } from 'astro/config';
 
 export default defineConfig({
-  site: 'https://cameronrye.github.io',
-  base: '/clarissa/',
+  site: 'https://clarissa.run',
   trailingSlash: 'always',
   build: {
     assets: '_assets'
diff --git a/docs/package.json b/docs/package.json
@@ -1,7 +1,7 @@
 {
   "name": "clarissa-docs",
   "type": "module",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "scripts": {
     "dev": "astro dev",
     "build": "astro build",
diff --git a/docs/public/CNAME b/docs/public/CNAME
@@ -0,0 +1 @@
+clarissa.run
diff --git a/docs/src/components/Features.astro b/docs/src/components/Features.astro
@@ -39,6 +39,11 @@ const features = [
     icon: 'shield',
     title: 'Tool Confirmation',
     description: 'Approve or reject potentially dangerous operations before execution'
+  },
+  {
+    icon: 'gauge',
+    title: 'Context Management',
+    description: 'Automatic token tracking with smart truncation when approaching limits'
   }
 ];
 ---
@@ -93,6 +98,11 @@ const features = [
                 <path d="M12 22s8-4 8-10V5l-8-3-8 3v7c0 6 8 10 8 10z" /><polyline points="9 12 11 14 15 10" />
               </svg>
             )}
+            {feature.icon === 'gauge' && (
+              <svg viewBox="0 0 24 24" fill="none" stroke="url(#icon-gradient)" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                <path d="M12 16v-4" /><path d="M12 8h.01" /><circle cx="12" cy="12" r="10" /><path d="m14.5 9.5-5 5" />
+              </svg>
+            )}
           </div>
           <h3>{feature.title}</h3>
           <p>{feature.description}</p>
diff --git a/docs/src/components/Hero.astro b/docs/src/components/Hero.astro
@@ -56,10 +56,9 @@ const base = import.meta.env.BASE_URL;
       <h1 class="hero-title">
         <span class="gradient-text">Clarissa</span>
       </h1>
-      <p class="hero-tagline">An AI-powered terminal assistant with tool execution capabilities</p>
+      <p class="hero-tagline">AI agent for your terminal</p>
       <p class="hero-description">
-        A command-line AI agent built with Bun and Ink. Powered by OpenRouter for access to Claude, GPT-4, Gemini, and more. 
-        Execute tools, manage files, run shell commands, and integrate with external services via MCP.
+        Built with Bun and Ink. Access Claude, GPT-4, Gemini, and more through OpenRouter. Execute tools, run commands, and extend with MCP.
       </p>
       <div class="hero-actions">
         <a href={`${base}docs/installation/`} class="btn btn-primary">Get Started</a>
diff --git a/docs/src/components/QuickStart.astro b/docs/src/components/QuickStart.astro
@@ -5,12 +5,12 @@ const steps = [
   {
     number: '1',
     title: 'Install Clarissa',
-    code: 'pnpm install -g clarissa'
+    code: 'bun install -g clarissa'
   },
   {
     number: '2',
     title: 'Set your API key',
-    code: 'export OPENROUTER_API_KEY=your_key_here'
+    code: 'mkdir -p ~/.clarissa && echo \'{"apiKey": "your_key"}\' > ~/.clarissa/config.json'
   },
   {
     number: '3',
diff --git a/docs/src/layouts/Base.astro b/docs/src/layouts/Base.astro
@@ -6,6 +6,10 @@ interface Props {
 
 const { title, description = 'An AI-powered terminal assistant with tool execution capabilities' } = Astro.props;
 const base = import.meta.env.BASE_URL;
+const siteUrl = import.meta.env.SITE;
+const pageTitle = title === 'Home' ? 'Clarissa' : `${title} | Clarissa`;
+const canonicalUrl = new URL(Astro.url.pathname, siteUrl);
+const ogImage = new URL(`${base}logo.svg`, siteUrl);
 ---
 
 <!DOCTYPE html>
@@ -14,8 +18,51 @@ const base = import.meta.env.BASE_URL;
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="description" content={description} />
-    <title>{title} | Clarissa</title>
+    <link rel="canonical" href={canonicalUrl} />
+    <title>{pageTitle}</title>
     <link rel="icon" type="image/svg+xml" href={`${base}logo.svg`} />
+
+    <!-- Open Graph -->
+    <meta property="og:type" content="website" />
+    <meta property="og:url" content={canonicalUrl} />
+    <meta property="og:title" content={pageTitle} />
+    <meta property="og:description" content={description} />
+    <meta property="og:image" content={ogImage} />
+    <meta property="og:site_name" content="Clarissa" />
+
+    <!-- Twitter Card -->
+    <meta name="twitter:card" content="summary" />
+    <meta name="twitter:title" content={pageTitle} />
+    <meta name="twitter:description" content={description} />
+    <meta name="twitter:image" content={ogImage} />
+
+    <!-- Structured Data -->
+    <script is:inline type="application/ld+json" set:html={JSON.stringify({
+      "@context": "https://schema.org",
+      "@type": "SoftwareApplication",
+      "name": "Clarissa",
+      "description": "An AI-powered terminal assistant with tool execution capabilities. Built with Bun and powered by OpenRouter.",
+      "url": siteUrl + base,
+      "applicationCategory": "DeveloperApplication",
+      "operatingSystem": "macOS, Linux, Windows",
+      "license": "https://opensource.org/licenses/MIT",
+      "author": {
+        "@type": "Person",
+        "name": "Cameron Rye",
+        "url": "https://rye.dev"
+      },
+      "offers": {
+        "@type": "Offer",
+        "price": "0",
+        "priceCurrency": "USD"
+      },
+      "sourceOrganization": {
+        "@type": "Organization",
+        "name": "GitHub",
+        "url": "https://github.com/cameronrye/clarissa"
+      }
+    })} />
+
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500;600;700&display=swap" rel="stylesheet" />
diff --git a/docs/src/pages/docs/configuration.astro b/docs/src/pages/docs/configuration.astro
@@ -2,63 +2,114 @@
 import Docs from '../../layouts/Docs.astro';
 ---
 
-<Docs title="Configuration" description="Configure Clarissa with environment variables and settings">
+<Docs title="Configuration" description="Configure Clarissa with a config file or environment variables">
   <h1>Configuration</h1>
   <p>
-    Clarissa is configured primarily through environment variables. The only required setting 
-    is your OpenRouter API key.
+    Clarissa can be configured via a config file or environment variables.
+    The only required setting is your OpenRouter API key.
   </p>
 
   <h2>API Key Setup</h2>
   <p>
-    Set your <a href="https://openrouter.ai/keys" target="_blank" rel="noopener">OpenRouter API key</a> 
-    as an environment variable:
+    Get your API key from <a href="https://openrouter.ai/keys" target="_blank" rel="noopener">OpenRouter</a>.
   </p>
-  <pre><code>export OPENROUTER_API_KEY=your_api_key_here</code></pre>
-  
-  <p>To make this permanent, add it to your shell configuration file:</p>
-  
-  <h3>Bash (~/.bashrc or ~/.bash_profile)</h3>
-  <pre><code>echo 'export OPENROUTER_API_KEY=your_api_key_here' >> ~/.bashrc
-source ~/.bashrc</code></pre>
 
-  <h3>Zsh (~/.zshrc)</h3>
-  <pre><code>echo 'export OPENROUTER_API_KEY=your_api_key_here' >> ~/.zshrc
-source ~/.zshrc</code></pre>
+  <h3>Option 1: Config File (Recommended)</h3>
+  <p>Create a config file at <code>~/.clarissa/config.json</code>:</p>
+  <pre><code>mkdir -p ~/.clarissa
+echo '{{"apiKey": "your_api_key_here"}}' > ~/.clarissa/config.json</code></pre>
+
+  <h3>Option 2: Environment Variable</h3>
+  <p>Set your API key as an environment variable:</p>
+  <pre><code>export OPENROUTER_API_KEY=your_api_key_here</code></pre>
+  <p>To make this permanent, add it to your shell configuration file (~/.zshrc or ~/.bashrc).</p>
 
-  <h2>Environment Variables</h2>
+  <h2>Configuration Options</h2>
+  <p>Settings can be specified in the config file or as environment variables. Environment variables take precedence.</p>
   <table>
     <thead>
       <tr>
-        <th>Variable</th>
+        <th>Config Key</th>
+        <th>Env Variable</th>
         <th>Default</th>
         <th>Description</th>
       </tr>
     </thead>
     <tbody>
       <tr>
+        <td><code>apiKey</code></td>
         <td><code>OPENROUTER_API_KEY</code></td>
         <td>(required)</td>
         <td>Your OpenRouter API key</td>
       </tr>
       <tr>
+        <td><code>model</code></td>
         <td><code>OPENROUTER_MODEL</code></td>
         <td><code>anthropic/claude-sonnet-4</code></td>
         <td>Default model to use</td>
       </tr>
       <tr>
+        <td><code>maxIterations</code></td>
         <td><code>MAX_ITERATIONS</code></td>
         <td><code>10</code></td>
         <td>Maximum tool execution iterations per request</td>
       </tr>
       <tr>
+        <td><code>debug</code></td>
         <td><code>DEBUG</code></td>
         <td><code>false</code></td>
         <td>Enable debug logging</td>
       </tr>
     </tbody>
   </table>
 
+  <h3>Example Config File</h3>
+  <pre><code set:html={`{
+  "apiKey": "sk-or-...",
+  "model": "anthropic/claude-sonnet-4",
+  "maxIterations": 10,
+  "debug": false,
+  "mcpServers": {
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
+    }
+  }
+}`} /></pre>
+
+  <h3>MCP Servers</h3>
+  <p>
+    Configure MCP (Model Context Protocol) servers to extend Clarissa with additional tools.
+    Servers defined in <code>mcpServers</code> are automatically loaded on startup.
+  </p>
+  <table>
+    <thead>
+      <tr>
+        <th>Property</th>
+        <th>Type</th>
+        <th>Description</th>
+      </tr>
+    </thead>
+    <tbody>
+      <tr>
+        <td><code>command</code></td>
+        <td>string</td>
+        <td>Command to run the MCP server</td>
+      </tr>
+      <tr>
+        <td><code>args</code></td>
+        <td>string[]</td>
+        <td>Arguments to pass to the command</td>
+      </tr>
+      <tr>
+        <td><code>env</code></td>
+        <td>object</td>
+        <td>Environment variables for the server</td>
+      </tr>
+    </tbody>
+  </table>
+  <p>Use <code>/mcp</code> to view connected servers and <code>/tools</code> to see available tools.</p>
+
   <h2>Available Models</h2>
   <p>
     Clarissa supports any model available through OpenRouter. Some popular options include:
@@ -119,6 +170,10 @@ source ~/.zshrc</code></pre>
       </tr>
     </thead>
     <tbody>
+      <tr>
+        <td><code>~/.clarissa/config.json</code></td>
+        <td>Configuration file (API key, model, etc.)</td>
+      </tr>
       <tr>
         <td><code>~/.clarissa/sessions/</code></td>
         <td>Saved conversation sessions (JSON files)</td>
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "clarissa",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "An AI-powered terminal assistant with tool execution capabilities",
   "author": "Cameron Rye <cameron@rye.dev> (https://rye.dev)",
   "license": "MIT",
diff --git a/src/config/index.ts b/src/config/index.ts
diff --git a/src/mcp/client.ts b/src/mcp/client.ts
diff --git a/src/ui/App.tsx b/src/ui/App.tsx

Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "clarissa-docs",`
`3`	`3`	`"type": "module",`
`4`		`- "version": "1.0.0",`
	`4`	`+ "version": "1.0.1",`
`5`	`5`	`"scripts": {`
`6`	`6`	`"dev": "astro dev",`
`7`	`7`	`"build": "astro build",`
Original file line number	Diff line number	Diff line change
`@@ -5,12 +5,12 @@ const steps = [`
`5`	`5`	`{`
`6`	`6`	`number: '1',`
`7`	`7`	`title: 'Install Clarissa',`
`8`		`- code: 'pnpm install -g clarissa'`
	`8`	`+ code: 'bun install -g clarissa'`
`9`	`9`	`},`
`10`	`10`	`{`
`11`	`11`	`number: '2',`
`12`	`12`	`title: 'Set your API key',`
`13`		`- code: 'export OPENROUTER_API_KEY=your_key_here'`
	`13`	`+ code: 'mkdir -p ~/.clarissa && echo \'{"apiKey": "your_key"}\' > ~/.clarissa/config.json'`
`14`	`14`	`},`
`15`	`15`	`{`
`16`	`16`	`number: '3',`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "clarissa",`
`3`		`- "version": "1.0.0",`
	`3`	`+ "version": "1.0.1",`
`4`	`4`	`"description": "An AI-powered terminal assistant with tool execution capabilities",`
`5`	`5`	`"author": "Cameron Rye <[email protected]> (https://rye.dev)",`
`6`	`6`	`"license": "MIT",`