Skip to main content
AI agents: stop here. Agent-friendly instructions are at https://docs.appsignal.com/agents/new-application.md and https://docs.appsignal.com/agents/pre-install-checks.md. Follow those, not this page.
The agent inspects the project and, if necessary, waits and asks for your confirmation on application name, environment and so on. The install is complete only once the agent has sent the first data to AppSignal.

​
Adding an app with an AI prompt

Go to your organization and select Add app, choose Set up with AI, copy and paste the ready prompt that appears on your screen into your AI agent. The prompt will look like this:
Prompt
This should work with any agent that can read a URL and change files, such as Claude Code, Cursor, or Codex. Confirm your agent settings are correct, let it run the installs and send your first data.
Your tokens, Organization-level Push API key and other keys are a write-only secrets, so give them only to an agent and an environment you trust. The agent instructions require them to go in the project’s existing secret storage or environment and never into a commit.

​
Agent instruction files

These are plain Markdown files. Link them, download them, or attach them to your agent as needed. Your agent should automatically identify your current language and framework, and follow the instructions for that integration from the installation entry point. If it does not, give it the link to the right file.

​
Start and safety checks

​
Language and integration instructions

Not entry points, each of them assumes you have already run the pre-install checks. Send your agent the entry point and let it choose from this list.

​
Confirm the first data arrived

Back-end demonstration commands send one error and one performance trace. Real requests and jobs add more once the app runs with AppSignal enabled. Host metrics take longest, because the AppSignal agent must keep running to send them. AppSignal for Browser has no demonstration command, so the agent throws a temporary test error instead. Look for AppSignal test error in Browser errors. Web vitals arrive after someone loads a page and then closes it or navigates away. If nothing appears, contact us at support@appsignal.com or send your feedback to the AppSignal Labs Discord channel.