initial commit

Author: odellus

.github/workflows/deploy.yaml

@@ -0,0 +1,63 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 18.x
+
+      - name: Install MyST
+        run: npm install -g mystmd
+
+      - name: Build MyST docs
+        run: |
+          cd docs
+          myst build --html
+
+      - name: Assemble site
+        run: |
+          mkdir -p _site
+          # Landing page from site/
+          cp index.html _site/
+          cp icon.ico _site/
+          cp crow-icon-white.ico _site/
+          cp crow-icon-white.svg _site/
+          cp crow-logo.svg _site/
+          # MyST docs at /docs
+          cp -r docs/_build/html _site/docs
+
+      - name: Setup Pages
+        uses: actions/configure-pages@v4
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: _site
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

CNAME

@@ -0,0 +1,2 @@
+www.crow-ai.dev
+crow-ai.dev

crow-icon-white.ico

@@ -0,0 +1,32 @@
+---
+title: Installation
+---
+
+# Installation
+
+## Requirements
+
+- Python 3.11+
+- [uv](https://docs.astral.sh/uv/) package manager
+
+## Install with uv
+
+```bash
+uv tool install crow-cli --python 3.14
+```
+
+## Verify Installation
+
+```bash
+crow-cli --version
+```
+
+## Development Install
+
+For contributing or development:
+
+```bash
+git clone https://github.com/crow-ai/crow-cli
+cd crow-cli
+uv sync
+```

crow-icon-white.svg

@@ -0,0 +1,63 @@
+---
+title: Quick Start
+---
+
+# Quick Start
+
+## Create an Agent
+
+```python
+from crow_cli import Agent
+
+agent = Agent(
+    model="gpt-4",
+    system_prompt="You are a helpful assistant."
+)
+
+response = await agent.run("Hello!")
+print(response)
+```
+
+## Add Tools
+
+```python
+from crow_cli import Agent
+from fastmcp import FastMCP
+
+mcp = FastMCP("my-tools")
+
+@mcp.tool()
+def get_weather(city: str) -> str:
+    """Get weather for a city."""
+    return f"Weather in {city}: Sunny, 72°F"
+
+agent = Agent(
+    model="gpt-4",
+    mcp_servers=[mcp]
+)
+
+response = await agent.run("What's the weather in Tokyo?")
+```
+
+## Session Persistence
+
+```python
+from crow_cli import Agent
+
+agent = Agent(
+    model="gpt-4",
+    session_id="my-session"  # Persists to SQLite
+)
+
+# First message
+await agent.run("My name is Alice")
+
+# Later... remembers context
+await agent.run("What's my name?")  # "Your name is Alice"
+```
+
+## Next Steps
+
+- [](../guides/configuration.md) - Configure your agent
+- [](../guides/tools.md) - Add more tools
+- [](../api/agent.md) - Full API reference

crow-logo.svg

@@ -0,0 +1,58 @@
+---
+title: crow-cli Documentation
+---
+
+# crow-cli Documentation
+
+Minimal Native ACP Agent Framework. No frameworks, just OpenAI SDK, FastMCP, and SQLAlchemy.
+
+```{toctree}
+:maxdepth: 2
+:caption: Getting Started
+
+getting-started/installation
+getting-started/quickstart
+```
+
+```{toctree}
+:maxdepth: 2
+:caption: Guides
+
+guides/configuration
+guides/tools
+guides/sessions
+```
+
+```{toctree}
+:maxdepth: 2
+:caption: Reference
+
+api/agent
+api/tools
+api/sessions
+```
+
+---
+
+## Quick Install
+
+```bash
+uv tool install crow-cli --python 3.14
+```
+
+## Features
+
+- **Native ACP Agent**: No framework lock-in
+- **FastMCP Integration**: Tool calling via MCP
+- **Session Persistence**: SQLite-backed sessions
+- **Streaming**: Real-time response streaming
+
+## Why crow-cli?
+
+Most agent frameworks are heavy abstractions. crow-cli is a reference implementation that shows you exactly how things work:
+
+- OpenAI SDK for LLM calls
+- FastMCP for tool integration
+- SQLAlchemy for persistence
+
+No magic, just code you can understand and modify.

docs/getting-started/installation.md

@@ -0,0 +1,19 @@
+version: 1
+project:
+  title: crow-cli
+  description: Minimal Native ACP Agent Framework
+  github: https://github.com/crow-ai/crow-cli
+  license: MIT
+
+site:
+  title: crow-cli Documentation
+  template: book-theme
+  options:
+    favicon: ../icon.ico
+    logo: ../crow-logo.svg
+    logo_dark: ../crow-logo.svg
+    logo_text: crow-cli
+    logo_url: /
+    style: styles/purple.css
+    hide_outline: false
+    hide_search: false