Your app. Your agents. One feedback loop.

Connect your project

Sign in to ShakeToShip, create a project, and connect the GitHub repository where feedback issues should appear.

1. 01Create your project in the dashboard.
2. 02Install the ShakeToShip GitHub App for the repository you want to use.
3. 03Open Agent setup and copy the project setup prompt into your coding agent.

Add feedback to your app

The setup prompt gives your agent the Swift package, project settings, and upload token. It can add the SDK and configure your app.

https://github.com/noktadev/shaketoship-swift

1. 01Add the ShakeToShip package to your app target with Swift Package Manager.
2. 02Attach .shakeToShip(config:) at your SwiftUI root.
3. 03Store FEEDBACK_COLLECTOR_URL and FEEDBACK_SECRET in a gitignored feedback.local.xcconfig. Use the project's upload token as FEEDBACK_SECRET.

The setup prompt contains project credentials. Give it only to your trusted coding agent. Keep credentials out of source control.

Send a test report

Build your app, enable feedback, and shake your phone. Explain a problem and send the report. Check that its GitHub issue includes the evidence.

1. 01Use the same upload URL and upload token in local builds and your CI build configuration, including Xcode Cloud.
2. 02Have your agent create the gitignored configuration before the archive build. Keep setup and admin tokens out of the app.
3. 03Check the report in your project's Sessions page and follow its GitHub issue link.

Connect your coding agents

Run this command from your app's Git repository. It installs the sts CLI, connects MCP, and adds the feedback skill for Claude Code, Codex, and Cursor.

curl -fsSL https://shaketoship.com/install | sh

macOS and Linux. No Node.js, Bun, or package manager required. The installer adds project settings and preserves existing connections.

1. 01Restart your coding agent and approve the ShakeToShip MCP connection when prompted.
2. 02Supply STS_TOKEN through the agent's environment. Use a setup or admin token from the dashboard, not the app's upload token. Setup tokens expire after one hour.
3. 03Give your agent a feedback issue and ask it to investigate or fix it. Issue URLs require an authenticated GitHub CLI; direct job IDs work without it.

The CLI downloads evidence. MCP lets your agent request it as a tool. The skill explains how to investigate and test a fix. ShakeToShip processes recordings for you.