update docs and env

yujonglee · yujonglee · commit 330d811c80f1 · 2025-11-29T16:20:28.000+09:00
diff --git a/apps/api/AGENTS.md b/apps/api/AGENTS.md
@@ -0,0 +1,9 @@
+```bash
+# REPO="SOMEWHERE" ($HOME/repos/hyprnote inside Devin)
+infisical export \
+  --env=dev \
+  --secret-overriding=false \
+  --format=dotenv-export \
+  --output-file="$REPO/apps/api/.env" \
+  --projectId=0dd35732-265e-41e1-86d5-abeda08e568d
+```
diff --git a/apps/api/package.json b/apps/api/package.json
@@ -19,6 +19,7 @@
     "zod-openapi": "^5.4.5"
   },
   "devDependencies": {
+    "@dotenvx/dotenvx": "^1.51.1",
     "@types/bun": "^1.3.3",
     "typescript": "^5.9.3"
   }
diff --git a/apps/desktop/package.json b/apps/desktop/package.json
@@ -112,6 +112,7 @@
     "zustand": "^5.0.8"
   },
   "devDependencies": {
+    "@dotenvx/dotenvx": "^1.51.1",
     "@faker-js/faker": "^10.1.0",
     "@tanstack/react-router-devtools": "^1.139.3",
     "@tanstack/router-plugin": "^1.139.3",
diff --git a/apps/restate/.gitignore b/apps/restate/.gitignore
@@ -1 +1 @@
-
+.wrangler/
diff --git a/apps/restate/AGENTS.md b/apps/restate/AGENTS.md
@@ -0,0 +1,9 @@
+```bash
+# REPO="SOMEWHERE" ($HOME/repos/hyprnote inside Devin)
+infisical export \
+  --env=dev \
+  --secret-overriding=false \
+  --format=dotenv-export \
+  --output-file="$REPO/apps/restate/.env" \
+  --projectId=f7a16b54-2e47-44a0-9eca-df4de6911f43
+```
diff --git a/apps/restate/package.json b/apps/restate/package.json
@@ -4,7 +4,7 @@
   "type": "module",
   "scripts": {
     "build": "tsc --noEmitOnError",
-    "dev": "dotenvx run -f ../../.env.supabase -f .env -- wrangler dev --port 9080",
+    "dev": "wrangler dev --port 9080 --env-file ../../.env.supabase --env-file .env",
     "start": "wrangler dev --port 9080",
     "deploy": "wrangler deploy",
     "typecheck": "tsc --noEmit"
@@ -18,6 +18,7 @@
   },
   "devDependencies": {
     "@cloudflare/workers-types": "^4.20240605.0",
+    "@dotenvx/dotenvx": "^1.51.1",
     "@restatedev/restate": "^1.5.0",
     "typescript": "^5.9.3",
     "wrangler": "^4.38.0"
diff --git a/apps/web/AGENTS.md b/apps/web/AGENTS.md
@@ -0,0 +1,9 @@
+```bash
+# REPO="SOMEWHERE" ($HOME/repos/hyprnote inside Devin)
+infisical export \
+  --env=dev \
+  --secret-overriding=false \
+  --format=dotenv-export \
+  --output-file="$REPO/apps/web/.env" \
+  --projectId=87dad7b5-72a6-4791-9228-b3b86b169db1
+```
diff --git a/apps/web/content/docs/developers/10.agents.mdx b/apps/web/content/docs/developers/10.agents.mdx
@@ -0,0 +1,18 @@
+---
+title: "AGENTS.md"
+section: "Developers"
+description: "List of all AGENTS.md files in the repository"
+---
+
+| Path | Link |
+|------|------|
+| `.github/AGENTS.md` | [View](https://github.com/fastrepl/hyprnote/blob/main/.github/AGENTS.md) |
+| `AGENTS.md` | [View](https://github.com/fastrepl/hyprnote/blob/main/AGENTS.md) |
+| `apps/api/AGENTS.md` | [View](https://github.com/fastrepl/hyprnote/blob/main/apps/api/AGENTS.md) |
+| `apps/desktop-e2e/AGENTS.md` | [View](https://github.com/fastrepl/hyprnote/blob/main/apps/desktop-e2e/AGENTS.md) |
+| `apps/restate/AGENTS.md` | [View](https://github.com/fastrepl/hyprnote/blob/main/apps/restate/AGENTS.md) |
+| `apps/web/AGENTS.md` | [View](https://github.com/fastrepl/hyprnote/blob/main/apps/web/AGENTS.md) |
+| `apps/web/content/changelog/AGENTS.md` | [View](https://github.com/fastrepl/hyprnote/blob/main/apps/web/content/changelog/AGENTS.md) |
+| `crates/notification-linux/AGENTS.md` | [View](https://github.com/fastrepl/hyprnote/blob/main/crates/notification-linux/AGENTS.md) |
+| `plugins/AGENTS.md` | [View](https://github.com/fastrepl/hyprnote/blob/main/plugins/AGENTS.md) |
+| `plugins/hooks/AGENTS.md` | [View](https://github.com/fastrepl/hyprnote/blob/main/plugins/hooks/AGENTS.md) |
diff --git a/apps/web/content/docs/developers/9.env.mdx b/apps/web/content/docs/developers/9.env.mdx
@@ -6,9 +6,8 @@ description: "Learn how to set environment variables for Hyprnote"
 
 # General 
 
-```bash
-dotenvx run -f .env.supabase -f .env -- <COMMAND>
-```
+- We use `dotenvx` to load environment variables.
+- Hyprnote team uses [infisical](https://infisical.com/docs/cli/commands/login) to manage them. (See `apps/web/AGENTS.md` for example.)
 
 # Supabase
 
@@ -31,7 +30,4 @@ S3_SECRET_KEY="850181e4652dd023b7a98c58ae0d2d34bd487ee0cc3254aed6eda37307425907"
 S3_REGION="local"
 ```
 
-# Infisical
-
-- Hyprnote team members use [infisical](https://infisical.com/docs/cli/commands/login) to access variables like `OPENROUTER_API_KEY` and `DEEPGRAM_API_KEY`.
-- This is pre-configured in our [Devin](https://devin.ai) instance too.
+See `apps/web/package.json`, `apps/api/package.json`, and `apps/restate/package.json` to see how `.env.supabase` is used.
diff --git a/apps/web/package.json b/apps/web/package.json
@@ -7,7 +7,8 @@
     "build": "vite build",
     "serve": "vite preview",
     "test": "playwright test",
-    "typecheck": "pnpm -F @hypr/web build && tsc --project tsconfig.json --noEmit"
+    "typecheck": "pnpm -F @hypr/web build && tsc --project tsconfig.json --noEmit",
+    "gen:agents": "node scripts/gen-agents.js"
   },
   "dependencies": {
     "@deepgram/sdk": "^4.11.2",
@@ -64,6 +65,7 @@
     "@content-collections/core": "^0.11.1",
     "@content-collections/mdx": "^0.2.2",
     "@content-collections/vite": "^0.2.7",
+    "@dotenvx/dotenvx": "^1.51.1",
     "@playwright/test": "^1.56.1",
     "@tailwindcss/typography": "^0.5.19",
     "@testing-library/dom": "^10.4.1",
diff --git a/apps/web/scripts/gen-agents.js b/apps/web/scripts/gen-agents.js
@@ -0,0 +1,64 @@
+import { readdir, writeFile } from "fs/promises";
+import { join, relative } from "path";
+import { dirname } from "path";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const repoRoot = join(__dirname, "../../..");
+const outputPath = join(__dirname, "../content/docs/developers/10.agents.mdx");
+
+const GITHUB_REPO = "fastrepl/hyprnote";
+const GITHUB_BASE_URL = `https://github.com/${GITHUB_REPO}/blob/main`;
+
+const SKIP_DIRS = new Set(["node_modules", "target", "dist"]);
+
+async function findAgentsFiles(dir, baseDir = dir, results = []) {
+  try {
+    const entries = await readdir(dir, { withFileTypes: true });
+
+    for (const entry of entries) {
+      if (entry.isDirectory() && SKIP_DIRS.has(entry.name)) {
+        continue;
+      }
+
+      const fullPath = join(dir, entry.name);
+
+      if (entry.isDirectory()) {
+        await findAgentsFiles(fullPath, baseDir, results);
+      } else if (entry.name === "AGENTS.md") {
+        const relativePath = relative(baseDir, fullPath);
+        results.push(relativePath);
+      }
+    }
+  } catch (err) {
+    // Ignore errors (e.g., permission denied)
+  }
+
+  return results;
+}
+
+async function main() {
+  const agentsFiles = await findAgentsFiles(repoRoot);
+  agentsFiles.sort();
+
+  let content = `---
+title: "AGENTS.md"
+section: "Developers"
+description: "List of all AGENTS.md files in the repository"
+---
+
+| Path | Link |
+|------|------|
+`;
+
+  for (const filePath of agentsFiles) {
+    const githubLink = `${GITHUB_BASE_URL}/${filePath}`;
+    content += `| \`${filePath}\` | [View](${githubLink}) |\n`;
+  }
+
+  await writeFile(outputPath, content, "utf-8");
+  console.log(`Generated ${outputPath}`);
+}
+
+main().catch(console.error);
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml

Original file line number	Diff line number	Diff line change
`@@ -19,6 +19,7 @@`
`19`	`19`	`"zod-openapi": "^5.4.5"`
`20`	`20`	`},`
`21`	`21`	`"devDependencies": {`
	`22`	`+ "@dotenvx/dotenvx": "^1.51.1",`
`22`	`23`	`"@types/bun": "^1.3.3",`
`23`	`24`	`"typescript": "^5.9.3"`
`24`	`25`	`}`