From 8e95dae31a2c88d931917129b690698e0490bb04 Mon Sep 17 00:00:00 2001 From: Mohamed Bassem Date: Sun, 7 Sep 2025 15:36:52 +0000 Subject: chore: Update the agent files --- AGENTS.md | 71 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++- CLAUDE.md | 2 +- GEMINI.md | 70 +------------------------------------------------------------- 3 files changed, 72 insertions(+), 71 deletions(-) mode change 120000 => 100644 AGENTS.md mode change 100644 => 120000 GEMINI.md diff --git a/AGENTS.md b/AGENTS.md deleted file mode 120000 index e3c5a92d..00000000 --- a/AGENTS.md +++ /dev/null @@ -1 +0,0 @@ -GEMINI.md \ No newline at end of file diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 00000000..d8f6d862 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,70 @@ +# Karakeep Project Overview + +This document provides context about the Karakeep project for the different agents. + +## Project Overview + +Karakeep is a monorepo project managed with Turborepo. It appears to be a web application with a focus on collecting and organizing information, possibly a bookmarking or "read-it-later" service. The project is built with a modern tech stack, including: + +- **Frontend:** Next.js, React, TypeScript, Tailwind CSS +- **Backend:** Hono (a lightweight web framework), tRPC +- **Database:** Drizzle ORM (likely with a relational database like PostgreSQL or SQLite) +- **Tooling:** Prettier,oxlint, Vitest, pnpm + +## Project Structure + +The project is organized into `apps` and `packages`: + +### Applications (`apps/`) + +- **`web`:** The main web application, built with Next.js. +- **`browser-extension`:** A browser extension, likely for saving content to karakeep. +- **`cli`:** A command-line interface for interacting with the service. +- **`landing`:** A landing page for the project. +- **`mobile`:** A mobile application (details unknown). +- **`mcp`:** The Model Context Protocol (MCP) server to communicate with Karakeep. +- **`workers`:** Background workers for processing tasks. + +### Packages (`packages/`) + +- **`api`:** The main API, built with Hono and tRPC. +- **`db`:** Database schema and migrations, using Drizzle ORM. +- **`e2e_tests`:** End-to-end tests for the project. +- **`open-api`:** OpenAPI specifications for the API. +- **`sdk`:** A software development kit for interacting with the API. +- **`shared`:** Shared code and types between packages. +- **`shared-react`:** Shared React components and hooks. +- **`shared-server`:** Shared logic that's meant to be used on the server-side. +- **`trpc`:** tRPC router and procedures. Most of the business logic is here. + +### Docs + +- **docs/docs/03-configuration.md**: Explains configuration options for the project. + +## Development Workflow + +- **Package Manager:** pnpm +- **Build System:** Turborepo +- **Code Formatting:** Prettier +- **Linting:** oxlint +- **Testing:** Vitest + +## Other info + +- This project uses shadcn/ui. The shadcn components in the web app are in `packages/web/components/ui`. +- This project uses Tailwind CSS. +- For the mobile app, we use [expo](https://expo.dev/). + +### Common Commands + +- `pnpm typecheck`: Typecheck the codebase. +- `pnpm lint`: Lint the codebase. +- `pnpm lint:fix`: Fix linting issues. +- `pnpm format`: Format the codebase. +- `pnpm format:fix`: Fix formatting issues. +- `pnpm test`: Run tests. +- `pnpm db:generate --name description_of_schema_change`: db migration after making schema changes + +Starting services: +- `pnpm web`: Start the web application (this doesn't return, unless you kill it). +- `pnpm workers`: Starts the background workers (this doesn't return, unless you kill it). diff --git a/CLAUDE.md b/CLAUDE.md index e3c5a92d..47dc3e3d 120000 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1 +1 @@ -GEMINI.md \ No newline at end of file +AGENTS.md \ No newline at end of file diff --git a/GEMINI.md b/GEMINI.md deleted file mode 100644 index 2ac6de48..00000000 --- a/GEMINI.md +++ /dev/null @@ -1,69 +0,0 @@ -# Gemini Code Assistant Workspace Context - -This document provides context about the Karakeep project for the Gemini Code Assistant. - -## Project Overview - -Karakeep is a monorepo project managed with Turborepo. It appears to be a web application with a focus on collecting and organizing information, possibly a bookmarking or "read-it-later" service. The project is built with a modern tech stack, including: - -- **Frontend:** Next.js, React, TypeScript, Tailwind CSS -- **Backend:** Hono (a lightweight web framework), tRPC -- **Database:** Drizzle ORM (likely with a relational database like PostgreSQL or SQLite) -- **Tooling:** Prettier, ESLint (via oxlint), Vitest, pnpm - -## Project Structure - -The project is organized into `apps` and `packages`: - -### Applications (`apps/`) - -- **`web`:** The main web application, built with Next.js. -- **`browser-extension`:** A browser extension, likely for saving content to karakeep. -- **`cli`:** A command-line interface for interacting with the service. -- **`landing`:** A landing page for the project. -- **`mobile`:** A mobile application (details unknown). -- **`mcp`:** The Model Context Protocol (MCP) server to communicate with Karakeep. -- **`workers`:** Background workers for processing tasks. - -### Packages (`packages/`) - -- **`api`:** The main API, built with Hono and tRPC. -- **`db`:** Database schema and migrations, using Drizzle ORM. -- **`e2e_tests`:** End-to-end tests for the project. -- **`open-api`:** OpenAPI specifications for the API. -- **`sdk`:** A software development kit for interacting with the API. -- **`shared`:** Shared code and types between packages. -- **`shared-react`:** Shared React components and hooks. -- **`trpc`:** tRPC router and procedures. Most of the business logic is here. - -### Docs - -- **docs/docs/03-configuration.md**: Explains configuration options for the project. - -## Development Workflow - -- **Package Manager:** pnpm -- **Build System:** Turborepo -- **Code Formatting:** Prettier -- **Linting:** oxlint -- **Testing:** Vitest - -## Other info - -- This project uses shadcn/ui. The shadcn components in the web app are in `packages/web/components/ui`. -- This project uses Tailwind CSS. -- For the mobile app, we use [expo](https://expo.dev/). - -### Common Commands - -- `pnpm typecheck`: Typecheck the codebase. -- `pnpm lint`: Lint the codebase. -- `pnpm lint:fix`: Fix linting issues. -- `pnpm format`: Format the codebase. -- `pnpm format:fix`: Fix formatting issues. -- `pnpm test`: Run tests. -- `pnpm db:generate --name description_of_schema_change`: db migration after making schema changes - -Starting services: -- `pnpm web`: Start the web application (this doesn't return, unless you kill it). -- `pnpm workers`: Starts the background workers (this doesn't return, unless you kill it). diff --git a/GEMINI.md b/GEMINI.md new file mode 120000 index 00000000..47dc3e3d --- /dev/null +++ b/GEMINI.md @@ -0,0 +1 @@ +AGENTS.md \ No newline at end of file -- cgit v1.2.3-70-g09d2