Contributing

Report what you find

StonkAgents is young software, and bugs get fixed as they are reported.

• Feedback form in the portal: the fastest way to reach the team.
• Contact page at stonkagents.com/contact for anything the feedback form does not fit, security reports included.
• Roadmap interest: when the portal shows a coming-soon state (macOS, the cloud agent, $AGENT), the link beside it records what you were after.

A good report says which portal you were on, the agent version from the update banner or GET http://localhost:7841/health, what you clicked, and what the page said. If the portal could not see your agent at all, say whether the browser’s local network permission was allowed.

The pieces

Component	What it is
Portal	The web app at stonkagents.com (Next.js)
Agent	The daemon and controller that run on your machine (Go), the tracker, and the Windows installer
Keeper	The scheduled jobs that claim platform fees, sweep the holder tax and run the buyback
Command tools	The stonkagents npm package, a fork of OpenClaw with the StonkAgents AI provider
Launch platform	The Raydium LaunchLab platform config and launch tooling
Docs	This site (Astro Starlight)

Documentation

This site is built from src/content/docs/**/*.mdx in the docs repository. Pull requests that fix a wrong sentence or clarify a step are welcome. The rule for these pages: describe what the portal does today, in the words it uses, and do not invent commands, flags or numbers. Every path, port, URL and figure on this site should be one somebody checked against a running system.

Code

• Fork, branch, open a pull request. The portal, the agent and the tools all run their test suites in CI; run them locally before pushing.
• Product decisions that shape the code (the $STONK-only quote, $AGENT on stonkfun, one launch per wallet, no claim step for holders) are documented in the repositories; a change to one of them is a product discussion first.

Code of conduct

Be direct. Be technical. Be helpful. No hype, no drama.