Cursor BYOK Frontend Guide
leookun/cursor-byok
Sets the rules for building the Cursor BYOK desktop app's React and Tauri frontend, especially its HTTP boundary and component state architecture.
Implement ordinary Research client features and fixes in React/Vite/Tauri, including its web, desktop, and mobile paths.
$ npx skills add MaplePrivacyLabs/Maple --skill develop-maple -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install MaplePrivacyLabs/Maple develop-maple --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/MaplePrivacyLabs/Maple.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/develop-maple .claude/skills/develop-maple && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "develop-maple" agent skill from https://github.com/MaplePrivacyLabs/Maple/tree/master/.agents/skills/develop-maple into .claude/skills/develop-maple/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "develop-maple", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/MaplePrivacyLabs/Maple/tree/master/.agents/skills/develop-mapleType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add MaplePrivacyLabs/Maple --skill develop-maple -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install MaplePrivacyLabs/Maple develop-maple --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/MaplePrivacyLabs/Maple.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/develop-maple .agents/skills/develop-maple && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "develop-maple" agent skill from https://github.com/MaplePrivacyLabs/Maple/tree/master/.agents/skills/develop-maple into .agents/skills/develop-maple/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "develop-maple", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add MaplePrivacyLabs/Maple --skill develop-maple -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install MaplePrivacyLabs/Maple develop-maple --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/MaplePrivacyLabs/Maple.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/develop-maple .cursor/skills/develop-maple && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "develop-maple" agent skill from https://github.com/MaplePrivacyLabs/Maple/tree/master/.agents/skills/develop-maple into .cursor/skills/develop-maple/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "develop-maple", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/MaplePrivacyLabs/Maple.git --path .agents/skills/develop-maple--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add MaplePrivacyLabs/Maple --skill develop-maple -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install MaplePrivacyLabs/Maple develop-maple --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/MaplePrivacyLabs/Maple.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/develop-maple .gemini/skills/develop-maple && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "develop-maple" agent skill from https://github.com/MaplePrivacyLabs/Maple/tree/master/.agents/skills/develop-maple into .gemini/skills/develop-maple/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "develop-maple", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install MaplePrivacyLabs/Maple develop-mapleInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add MaplePrivacyLabs/Maple --skill develop-maple -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/MaplePrivacyLabs/Maple.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/develop-maple .github/skills/develop-maple && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "develop-maple" agent skill from https://github.com/MaplePrivacyLabs/Maple/tree/master/.agents/skills/develop-maple into .github/skills/develop-maple/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "develop-maple", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add MaplePrivacyLabs/Maple --skill develop-maple -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install MaplePrivacyLabs/Maple develop-maple --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/MaplePrivacyLabs/Maple.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/develop-maple .opencode/skills/develop-maple && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "develop-maple" agent skill from https://github.com/MaplePrivacyLabs/Maple/tree/master/.agents/skills/develop-maple into .opencode/skills/develop-maple/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "develop-maple", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
develop-mapleImplement ordinary Research client features and fixes in React/Vite/Tauri, including its web, desktop, and mobile paths.
Develop Maple is an agent skill from MaplePrivacyLabs/Maple. Implement ordinary Research client features and fixes in React/Vite/Tauri, including its web, desktop, and mobile paths. Use for client setup, placement, focused development, and handoff; use the Agent Mode, SDK, proxy, validation, or release skills for those workflows.
Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).
It works with Tauri, Vite and React. The repository describes itself as: Maple - Private AI Chat. The licence is MIT.
Read from SKILL.md and the folder at commit 82f0b06. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Shell commands in SKILL.md call:
justnixgitFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Develop Maple loads about 1.1k tokens when it runs. Until then it costs about 71 tokens; SKILL.md has 428 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check noted patterns worth knowing about, such as sudo or a known installer.
test -e apps/maple-research/frontend/.env.local || cp apps/maple-research/frontend/.env.example apps/maple-research/fronAutomated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from MaplePrivacyLabs/Maple at commit 82f0b06, republished under its MIT licence (© MaplePrivacyLabs). 428 words, ~1,070 tokens.
.claude/skills/develop-maple/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.Work from the monorepo root. Read root and Research AGENTS.md, affected
source/tests, justfile, package manifests, flake and relevant CI. Research
includes the existing desktop Agent Mode; the independent hosted Auth and
GPUI Agent apps follow their own component guides.
Use the environment contract: Local for backend changes, heavy features, or specific frontend/backend/log/ billing interaction; hosted Dev is suitable for intentional small frontend work with a valid Dev-account login. Preserve selected API/project, account, auth route, and dependency endpoints.
Identify external ownership before configuring ignored env files, overlays, ports, or processes. Consume generated state and use its owner's lifecycle. Standalone setup is conditional on those resources being unowned:
nix develop --no-update-lock-file
./setup-hooks.sh
just install
test -e apps/maple-research/frontend/.env.local || cp apps/maple-research/frontend/.env.example apps/maple-research/frontend/.env.localChoose the smallest runtime exercising the change: just dev for web;
just desktop-dev for native/Agent Mode. These consume existing configuration;
for hosted Dev browser work, use the
explicit Dev profile loop.
For Research iOS, follow
the ONNX/runtime guide
and select the simulator/device explicitly. These are Tauri commands, not a
setup workflow for a new native Swift client. Debug/simulator does not imply
Local. Local baseline login uses encrypted password/account fixtures; native
OAuth is an intentional hosted/provider check with separate browser origin.
Keep UI/account-scoped state in apps/maple-research/frontend/src/ and native
effects in frontend/src-tauri/src/. OpenSecret owns authorization, persistence,
cryptography, provider/model policy and usage. Use selected SDK client contracts
and the consumer version policy;
do not duplicate encryption or emulate missing server enforcement in UI.
Read implementation contracts only for relevant placement, privileged IPC, account/cancellation, or runtime details. Preserve generated files through their generators and inspect deltas. Use Bun, component Cargo commands and owning pinned toolchains; do not add substitute lockfiles/toolchains or unrelated upgrades.
Load the matching workflow when the task crosses it:
$change-maple-agent-mode: embedded Goose/ACP/MCP, tools/permissions, subagents.$develop-opensecret-sdk or $develop-maple-proxy: their owned source/contracts.$review-maple-security: a trust-boundary change or security review.$validate-maple: validation beyond the focused loop and before handoff.$release-maple: explicitly authorized publication only.Reproduce the changed behavior, add focused behavior tests where they provide
useful proof, and run affected complete component gates before handoff using
$validate-maple. Frontend Bun commands use apps/maple-research/frontend/;
Rust commands use its src-tauri/. There is no root just test. The hook runs
selected frontend checks plus Research Rust formatting/tests; strict Clippy
is a separate optional diagnostic, not current Research CI/hook.
Inspect git diff --check, complete diff and status. Report changed behavior,
contracts/files, exact checks, effective environment and exact runtime evidence,
and untested boundaries. Preserve unrelated work and existing authorization.
Commit/push/PR/publication only within user-authorized scope; routine validation
does not authorize releases, master pushes, deployment, or store uploads.
© MaplePrivacyLabs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 1 other file in .agents/skills/develop-maple of MaplePrivacyLabs/Maple.
Open the folder on GitHubat commit 82f0b06
Develop Maple next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Develop Maple this skillMaplePrivacyLabs/Maple | 100 | — | ~1.1k | Automated safety check: Notes | MIT | |
| Cursor BYOK Frontend Guideleookun/cursor-byok | 3.2k | — | ~1.9k | Automated safety check: Pass | MIT | |
| Refactoratilladeniz/Kubeli | 387 | — | ~7.7k | Automated safety check: Warn | MIT | |
| Web Artifacts Builderanthropics/skills | 180k | 40 repos | ~769 | Automated safety check: Pass | Apache-2.0 | |
| React Router Developmentremix-run/react-router | 57k | 1 repos | ~1.5k | Automated safety check: Pass | MIT | |
| Chakra UI v3 Builderchakra-ui/chakra-ui | 41k | — | ~3.1k | Automated safety check: Pass | MIT |
leookun/cursor-byok
Sets the rules for building the Cursor BYOK desktop app's React and Tauri frontend, especially its HTTP boundary and component state architecture.
atilladeniz/Kubeli
Refactors code following Ousterhout's design principles. An agent skill from atilladeniz/Kubeli.
anthropics/skills
Builds multi-component claude.ai HTML artifacts as a small React, TypeScript and Tailwind project, then bundles it into one shareable HTML file.
remix-run/react-router
Guides work on React Router apps by first identifying whether the app uses Framework, Data or Declarative mode, then loading the matching reference and the installed package docs.
chakra-ui/chakra-ui
Builds responsive, accessible Chakra UI v3 components and layouts, sets up Chakra in new or existing projects, and designs themes with tokens, semantic tokens and recipes.
creativetimofficial/ui
Helps install, generate and review Creative Tim UI blocks: shadcn/ui-based React and Tailwind sections that follow a restrained, production-minded design philosophy.
MaplePrivacyLabs/Maple
Prepare, publish, monitor, and verify a Maple release from current master.
MaplePrivacyLabs/Maple
Develop and review the maple-proxy Rust crate, binary, container, and OpenAI-compatible HTTP behavior under Maple's proxy directory.
MaplePrivacyLabs/Maple
Develop and review the Maple TypeScript/React and Rust SDKs under Maple's sdk directory.
MaplePrivacyLabs/Maple
Review security-sensitive OpenSecret changes and claims. An agent skill from MaplePrivacyLabs/Maple.
MaplePrivacyLabs/Maple
Select and run Maple component checks, platform builds, and exact-runtime smoke evidence for the changed behavior.
MaplePrivacyLabs/Maple
Select and run backend Rust, disposable database, encrypted client, provider, Nix, and EIF/PCR evidence matching an OpenSecret change.
Implement ordinary Research client features and fixes in React/Vite/Tauri, including its web, desktop, and mobile paths. Develop Maple is an agent skill from MaplePrivacyLabs/Maple. Implement ordinary Research client features and fixes in React/Vite/Tauri, including its web, desktop, and mobile paths.
Develop Maple fits situations like: focused development; use the Agent Mode; release skills for those workflows.
Run `npx skills add MaplePrivacyLabs/Maple --skill develop-maple -a claude-code`. Or copy the skill folder (.agents/skills/develop-maple in MaplePrivacyLabs/Maple) into .claude/skills/develop-maple in your project. Claude Code loads it when a task matches its description.
Run `npx skills add MaplePrivacyLabs/Maple --skill develop-maple -a codex`. Or copy the skill folder (.agents/skills/develop-maple in MaplePrivacyLabs/Maple) into .agents/skills/develop-maple in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add MaplePrivacyLabs/Maple --skill develop-maple -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/develop-maple, .gemini/skills/develop-maple, .github/skills/develop-maple and .opencode/skills/develop-maple in your project.
Going by SKILL.md and its folder, Develop Maple needs the command-line tools its instructions call (just, nix and git).
SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
Develop Maple is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Develop Maple: Cursor BYOK Frontend Guide (leookun/cursor-byok, 3.2k stars), Refactor (atilladeniz/Kubeli, 387 stars), Web Artifacts Builder (anthropics/skills, 180k stars) and React Router Development (remix-run/react-router, 57k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
MaplePrivacyLabs (a GitHub organization) maintains it in MaplePrivacyLabs/Maple, which has 100 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 7, 2026.
Source: MaplePrivacyLabs/Maple on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.