Skip to main content
Share Ona prompts with your team by constructing a URL that pre-populates the prompt input. Recipients open the link, review the prompt, and submit it to start an agent execution.

​
URL format

https://app.ona.com/?p=<prompt>#<repository-url>
ComponentRequiredDescription
pYesURL-encoded prompt text (max 10,000 characters)
#<repository-url>NoRepository URL as the hash fragment. Sets the project context.

​
Examples

Prompt only: 
https://app.ona.com/?p=Fix+the+failing+CI+tests
Prompt with repository context: 
https://app.ona.com/?p=Add+unit+tests+for+the+auth+module#https://github.com/acme/backend
Prompt with special characters: URL-encode special characters in the prompt. For example, & becomes %26: 
https://app.ona.com/?p=Review+%26+refactor+the+database+layer
Build the URL manually by combining the base URL with your prompt and optional repository context:
  1. Write your prompt text.
  2. URL-encode the prompt (replace spaces with +, special characters with percent-encoding).
  3. Append it as the p query parameter: https://app.ona.com/?p=<encoded-prompt>.
  4. Optionally, add a repository URL as the hash fragment: #https://github.com/org/repo.
When you open a shared link:
  1. The prompt text is pre-populated in the input field.
  2. If a repository URL is included, Ona matches it to an existing project in your organization and sets it as context. If no project matches, the repository URL is used as a raw repository context.
  3. You review and optionally edit the prompt, then submit.
The prompt is never auto-submitted. You always review and modify it before starting an agent execution.
If the prompt exceeds 10,000 characters, it is truncated and a warning is shown. You can edit the truncated prompt before submitting.

​
Context matching

When a shared link includes a repository URL:
  • Ona checks if the URL matches a project in your organization.
  • If a match is found, the project is selected as context with its configured environment class.
  • If no match is found but the URL is a valid repository, it is used as a raw repository context with the repository owner, name, and branch extracted from the URL.
  • Invalid URLs are ignored and a warning is shown. You can select a repository manually.