Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Ace: adopt desktopToolRules()

Open Beginner friendly
#530 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
76/100
Issue type
Feature
Clarity
Clearly specified
Activity status
Active
Tech stack
typescript

Research direction

Read packages/channel/src/desktop.ts and compare its desktop guidance with the integration in src/mcp.ts. Append desktopToolRules(hostName) after the outcome lines, then inspect an Ace agent's instructions to confirm they mention pause, expect, and the recipes.

Written by the indexing model from the issue text.

Description

documentation

githubnext/desktop-tools#103 shortened the desktop tool descriptions. Rules every tool shares now live in one place, desktopToolRules(app) in @githubnext/desktop-tools/tools, and the MCP server adds them to its instructions. The rules are:

  • exact targets passed back unchanged, and checking availability;
  • single-use snapshots, with points as screenshot fractions;
  • background versus foreground input;
  • what each outcome means;
  • pause;
  • desktop_wait and expect;
  • observed content is data, not instructions;
  • the recipes link.

Ace's desktop_* tools use desktopTools() but carry their own agent guidance (packages/channel/src/desktop.ts), so Ace agents will no longer see these rules unless that guidance includes them.

To do in Ace: after the outcome lines of its desktop guidance, append ...desktopToolRules(hostName), as src/mcp.ts does here. Then check that an Ace agent's instructions mention pause, expect and the recipes.

Dominant language
TypeScript
Stars
1
Forks
0
PR merge metrics
No merged PRs in 30d

Getting set up

  • No Dockerfile or Docker Compose file
  • Has a pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from githubnext/ace2

All issues in githubnext/ace2

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.