44 lines
2.7 KiB
Plaintext
44 lines
2.7 KiB
Plaintext
# mp-silma-ai-aide
|
|
|
|
This project is a basic Vite + TypeScript Chrome extension scaffold. The extension side panel reads Gitea configuration from Vite env variables, stores side panel state in Zustand, and uses Axios to call the Gitea API.
|
|
|
|
Important files:
|
|
|
|
- `AGENTS.md`: Project instructions for coding agents.
|
|
- `manifest.llm.json`: Machine-readable project metadata.
|
|
- `docs/extension-management.md`: Chrome extension management instructions, including the required Chrome profile.
|
|
- `.env.example`: Required environment variables.
|
|
- `vite.config.ts`: Vite build config and generated Chrome extension manifest logic.
|
|
- `src/api.ts`: Axios client and Gitea configuration handling.
|
|
- `src/store.ts`: Vanilla Zustand side panel state store.
|
|
- `src/main.ts`: Side panel UI behavior.
|
|
- `index.html`: Side panel document.
|
|
- `public/icons/`: Extension icon source and generated PNG sizes copied into `dist/` by Vite.
|
|
- `public/local-context.json`: Generated workspace/repo/URL context copied into `dist/`.
|
|
- `scripts/generate-local-context.mjs`: Scans `/Users/Tabitha/.openclaw/workspace_Father` and writes `public/local-context.json`.
|
|
|
|
Build with `npm run build`. The deployable output directory is `dist/`; load that folder in Chrome as an unpacked extension or point deployment tooling at it. Do not edit `dist/` directly.
|
|
|
|
UI behavior: the app renders as a Chrome side panel, not a draggable window. The menu items are Add URL, URLs, Gitea Repos, Workspaces, and Add Issue. Add URL is enabled only when the active tab base URL is not already known; the user must choose either a workspace or a Gitea repo, and the app infers the linked counterpart. Add Issue is enabled only when the active tab base URL is known and linked to a Gitea repo. It shows the target repo, captures visible-tab screenshots, accepts file attachments, creates the Gitea issue, uploads assets, then applies the `ready` label if requested. Created issue bodies include `Chrome profile: Silma`. Gitea repos are ordered by latest default-branch commit. Workspace and URL views show established links between local workspaces, known URLs, and Gitea repos.
|
|
|
|
Extension management rule: use the Codex Chrome extension with the Chrome profile named `Silma`. Do not use `Profile 1`.
|
|
|
|
Codex commands:
|
|
|
|
- Setup: `npm run codex:setup`
|
|
- Dev: `npm run dev:codex`
|
|
- Build: `npm run build:codex`
|
|
- Verify output: `npm run verify:dist`
|
|
|
|
Required env variables:
|
|
|
|
- `VITE_GITEA_BASE_URL`
|
|
- `VITE_GITEA_TOKEN`
|
|
- `VITE_GITEA_REPO_OWNER`
|
|
- `VITE_GITEA_REPO_NAME`
|
|
|
|
Gitea workflows:
|
|
|
|
- `.gitea/workflows/build.yml`: build validation for pushes to `main` and pull requests.
|
|
- `.gitea/workflows/issue-opened-placeholder.yml`: new issue placeholder that prints `200 okay`.
|