GitHub Copilot + Raims
An editor assistant for planning and writing Raims integration code.
Quick start
Prepare the agent
Follow the official GitHub Copilot setup for your editor and sign in with a GitHub account that has Copilot access. This guide uses VS Code for configuration examples.
Open your project
Open the application folder you are connecting to Raims in VS Code. Open Copilot Chat and select the agent to work with the project code.
Add the documentation
Ask the agent to read Raims' documentation index and open the relevant guides. llms-full.txt provides the consolidated content. Start with authentication and charges.
Try a prompt
Read https://docs.raims.com/llms.txt and the authentication and charges guides. Inspect this application's backend and propose a plan to retrieve an existing Sandbox charge with GET /v1/charges/{id}. Prepare an example using protected server configuration for the key. Do not send requests or use real credentials. Show the sources and the files you would change before editing.
Project context
Create or update .github/copilot-instructions.md at your repository root. This file provides general instructions for Copilot sessions. Add the text below alongside your application's conventions.
# Raims integration
- Read https://docs.raims.com/llms.txt before choosing endpoints and fields.
- Use https://docs.raims.com/llms-full.txt for the consolidated documentation.
- API base URL: https://api.raims.com.
- In Raims product installation examples, select the latest stable version
through the package manager (`latest` where supported).
- Prepare examples for Sandbox, with Bearer authentication in the backend.
- Keep the key in protected server configuration. Never put secrets in code,
prompts, logs, or browser applications.
- Explain the plan and request authorization before sending API requests.Verify the setup
Ask the agent to identify the guides it read, the API base URL, and the place in your backend where the key will be loaded. It should prepare the plan and example without asking you to paste a real credential.
Reading the documentation does not authenticate the application. Requests use a Raims API key for the intended company and environment.
Common issues
Check that .github/copilot-instructions.md belongs to the folder open in
VS Code. Review the editor's instruction settings and ask the agent to read
the file explicitly.
Open the relevant guide in your browser and provide the public excerpt as context. Ask the agent to identify any missing information before suggesting code.
Ask the agent to review the authentication guide. The backend sends the Raims key with Bearer authentication; an AI provider credential does not replace it.