anomalyco / anomalyco/opencode
[FEATURE]: heartbeat tool in v2, structured use case of background shell
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 209k
- Forks
- 27.5k
- PR merge metrics
- PR metrics pending
Description
Feature hasn't been suggested before.
- I have verified this feature I'm about to request hasn't been suggested before.
Describe the enhancement you want to request
I've been using v2 recently and it's wonderful, the background shell is very helpful. I noticed an emerging use case that my agents often use the background shell as a heartbeat or timer (sleep 2000 && echo "do something").
I think it would be better if we can have this as a dedicated tool. This should make the transcript more structured, and make it more ergonomic, especially when paired with some UI element.
Similar to #50041, but that one's requesting a blocking tool. What I observed is a non blocking use case, piggybacked on the background shell in v2. #20874 #24888 are similar but are closed.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reading the v2 background-shell implementation and comparing the related discussions in #50041, #20874, and #24888. Define the dedicated non-blocking heartbeat tool's behavior and transcript representation; done means it supports the timer use case without relying on a background shell and leaves a structured record suitable for UI integration.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- typescript
- Domain
- developer-experience, tooling
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Active
- Clarity
- Needs clarification
- Newbie friendliness
- 35/100