Kelvin Github Coding Agent¶

AI-Accelerated Development¶

Applications is optimized for Agentic Workflows.

By embedding specific instruction sets for AI assistants, like GitHub Copilot, Claude, and Cursor, into our kelvin app create structure we enable the agent to understand our SDK and Kelvin Platform structure, reducing hallucinations and making natural language development fast and precise.

What is an Agentic Workflow?¶

Unlike standard autocomplete, an agentic workflow involves an AI "agent" that understands the context of your entire project. When you use the Kelvin SDK, these agents don't just guess code—they follow our pre-defined Instruction Files to:

• Implement Features: Write boilerplate-free code using the latest SDK syntax.
• Validate Logic: Automatically generate tests that match our internal standards.
• Self-Correct: Debug SDK-specific errors by referencing our "Known Patterns" documentation.

Key AI Integration Files¶

To ensure your AI assistant is "SDK-aware," we have included the following configuration files in the repository root:

Getting Started¶

1. Create the project using one of two agent-optimized methods:
   • Kelvin UI: Select Create Application to launch a pre-configured GitHub Codespace. This environment automatically initializes the required instruction files, ensuring your AI agent is instantly "SDK-aware."
   • Kelvin CLI: Execute kelvin app create in your terminal to bootstrap the project structure locally, including the AGENT.md and configuration files necessary for natural language development.
2. Open the project in your preferred AI-enabled IDE (VS Code with Copilot, Cursor, etc.).
3. Verify the instructions: The IDE will automatically detect the configuration files listed above.
4. Prompt with intent: Instead of writing code, ask the agent: "Use the Kelvin SDK to create a new authenticated session and list all active resources."

In this interactive demonstration below we ask GitHUb Copilot the following;

Create an event detection app that will monitor two data streams in real time and if the difference between the two is more that 5% then change the setpoint of the third data stream up by 10%.

Now click on Get Started button below to see for yourself in this interactive tour how GitHub Copilot works.

Update the Agentic Instruction Files from the Latest Source¶

The AI integration files listed above are versioned alongside the Kelvin SDK. As new SDK features and patterns are released, the instruction sets are updated to reflect them. To pull the latest versions into your project, run the following command from the root of your Kelvin project folder:

kelvin app agent sync

This downloads the latest AGENTS.md and .skills directory from the Kelvin agents repository, matched to the version configured for your logged-in platform instance. It then creates or updates the following symlinks so every supported AI coding assistant points to the same shared instruction set:

Options¶

Examples:

# Sync using the version configured for your platform instance (requires login)
kelvin app agent sync

# Sync to a specific app directory
kelvin app agent sync --app-dir="./my-app"

# Sync to the latest published version without a login session
kelvin app agent sync --latest

# Sync to a specific version
kelvin app agent sync --version 1.2.3