Implement or stub Neru functionality for a specific OS/backend: port contract, build-tagged file slots, factory wiring, CodeNotSupported stubs, capability matrix, contract tests, and the docs ownership table. Use for any change under internal/adapter/platform or any *_darwin/_linux/_windows file. Not for pure-Go domain logic.
The English summary is being prepared. Showing the original description.
Run score Not tested
See how to installReview the instructions the agent will receive before you install.
Platform code carries Neru's strictest guardrails, and this is where agents
most often guess. A change that lands cleanly sits in an existing file slot,
crosses the boundary through a port, returns CodeNotSupported wherever it is
unimplemented, and reports itself honestly in the capability matrix.
internal/adapter/platform/AGENTS.md, the single home for the rules
this skill obeys: the One Rule, file slots, the factory and Linux's runtime
compositor axis, loud stubs, capability honesty, coordinates, generated
Wayland bindings. Add the darwin/ or linux/ guide for the native
boundary you touch.internal/adapter/platform/profile.go. It is the source of truth for
each subsystem's backend family, primary-modifier expectations, and whether
a backend needs CGO. CGO is a per-backend decision, not a per-OS one.internal/ports/. If the capability
doesn't have a port yet, define the interface there first and add a mock in
internal/ports/mocks.*_integration_<os>_test.go tagged
//go:build integration && <os>.CodeNotSupported per subsystem, not per stub. Update the
subsystem's existing one if it has one, and write a new one when a caller
could read the stub's nil as success, so a later "implementation" that
silently no-ops fails a test. internal/adapter/platform/AGENTS.md names the
ones that exist.docs/contributing/porting.md has the ownership table ("Documentation Checklist"),
and each fact has exactly one home. Capability status goes in
docs/reference/platform-support.md, the API or protocol behind it in
docs/contributing/platform-internals.md, and never either in
docs/contributing/architecture.md (shape only).
Linux setup specifics go in docs/guide/linux.md / docs/guide/linux-desktops.md.
just lint # depguard enforces the One Rule
go test ./internal/architecture/
just test-foundation
Cross-compile the platforms you touched (just build-linux,
just build-windows) even when you can't run them, because build tags hide breakage
from a darwin-only just build. Then the standard pre-commit gate, and ask a
maintainer to run integration tests on the target OS if you can't.
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Add a Neru CLI command or flag: cobra command in internal/cli, IPC handler in internal/app/ipcctrl, service/mode work behind it, man pages, and docs/reference/cli.md. Use when adding or changing user-facing commands, subcommands, or flags. Not for config.toml options.
The English summary is being prepared. Showing the original description.
Add or change a Neru config.toml option end to end: struct field, shared and platform defaults, validation, examples, docs, and hot-reload behavior. Use whenever a change adds, renames, or removes a key in the TOML config schema. Not for theme palette entries or CLI flags.
The English summary is being prepared. Showing the original description.
Answer a Neru user's question about what Neru does, which command, flag, or config key does a thing, why something does not work, or what to try next, from the help, man pages, and docs of their installed version rather than from memory. Routes config work to neru-setup-config. Use when a Neru user asks what Neru can do, how to do something with it, which command to run, why hints or a hotkey do nothing, or which skill to use.
The English summary is being prepared. Showing the original description.
Help a Neru user build a tool on top of Neru, such as a status bar, a launcher, voice control, a companion UI, automation from another hotkey tool, a Go program, or a client for the IPC socket in another language. Picks the interface, checks the installed version has it, reads the contract from that version's docs, and runs the result against the live daemon. Routes config and hooks work to neru-setup-config. Use when a Neru user wants to script Neru, read its state, follow its events, drive it from another program, or write code against its CLI, socket, or Go client.
The English summary is being prepared. Showing the original description.
Commit working changes and open a Neru pull request the maintainer's way: conventional commit subjects, a PR title written for the changelog, the just ci gate, and the repo PR template filled honestly. Use when asked to commit, create a PR, open a pull request, or ship finished work in this repo.
The English summary is being prepared. Showing the original description.
File a Neru bug report or feature request that matches the repo's issue forms: duplicate check first, every required field filled with real diagnostics, correct labels. Use when asked to open, file, or draft a GitHub issue for Neru. Not for pull requests.
The English summary is being prepared. Showing the original description.