From ff3078e93411c3467d797258744a7f17a7dbdf0a Mon Sep 17 00:00:00 2001
From: polwex <polwex@sortug.com>
Date: Wed, 16 Jul 2025 10:07:06 +0700
Subject: m

---
 CLAUDE.md | 66 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)
 create mode 100644 CLAUDE.md

(limited to 'CLAUDE.md')

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..c08d8c8
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,66 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+SORMARK is a bookmark management application that uses LLMs to analyze and categorize bookmarks from Twitter (X), browser bookmarks, and other sources. The LLM processes each bookmark to categorize it, read linked content, and decide actions like storing in an Obsidian-like vault or creating calendar events.
+
+## Tech Stack
+- **Frontend**: Waku (React framework with server components)
+- **Runtime**: Bun
+- **Styling**: Tailwind CSS v4
+- **Language**: TypeScript with strict configuration
+- **Development**: Devenv for environment management
+
+## Development Commands
+
+### Getting Started
+```bash
+# Enter development environment
+direnv allow  # or devenv shell
+
+# Install dependencies
+bun install
+```
+
+### Running the Application
+```bash
+# Development server
+bun dev
+
+# Build for production
+bun build
+
+# Start production server
+bun start
+```
+
+### Environment Setup
+The project uses devenv for environment management. Key environment variables:
+- `ANTHROPIC_BASE_URL`: Set to "https://api.moonshot.ai/anthropic"
+- `ANTHROPIC_AUTH_TOKEN`: API key for LLM integration (already configured)
+- `TWITTER_COKI`: Cookie used on the x.com frontend.
+
+## Project Structure
+```
+app/
+├── src/
+│   ├── pages/           # Waku pages (file-based routing)
+│   │   ├── _layout.tsx  # Root layout component
+│   │   ├── index.tsx    # Home page
+│   │   └── about.tsx    # About page
+│   ├── components/      # React components
+│   │   ├── counter.tsx  # Client-side counter example
+│   │   ├── header.tsx   # Site header
+│   │   └── footer.tsx   # Site footer
+│   └── styles.css       # Global styles with Tailwind
+├── public/              # Static assets
+└── package.json         # Dependencies and scripts
+```
+
+## Architecture Notes
+- Uses Waku framework with React Server Components
+- File-based routing in `src/pages/` directory
+- Static rendering configured for all pages
+- Client components use `'use client'` directive
+- Tailwind CSS v4 configured with PostCSS
-- 
cgit v1.2.3