|
| 1 | +--- |
| 2 | +title: Using AI Agents |
| 3 | +--- |
| 4 | + |
| 5 | +AI-powered development tools can significantly accelerate your workflow when building Harper applications. Whether you want a dedicated assistant or prefer using your favorite LLM, Harper provides the tools and context needed to make AI an effective part of your development process. |
| 6 | + |
| 7 | +## Harper Agent |
| 8 | + |
| 9 | +The `harper-agent` is a purpose-built AI assistant designed specifically for Harper development. It understands the Harper ecosystem and can help you with tasks ranging from project setup to debugging. |
| 10 | + |
| 11 | +https://github.com/HarperFast/harper-agent |
| 12 | + |
| 13 | +### Features |
| 14 | + |
| 15 | +- **Application Creation**: Scaffold full Harper applications from natural language descriptions. |
| 16 | +- **Code Generation**: Write schema definitions, custom functions, and integration code. |
| 17 | +- **Diagnosis and Running**: Run your application and let the agent diagnose and fix errors. |
| 18 | +- **Browser Control**: The agent can even interact with a browser to help you test and manage your applications. |
| 19 | + |
| 20 | +### Installation |
| 21 | + |
| 22 | +Install the Harper Agent globally using npm: |
| 23 | + |
| 24 | +```bash |
| 25 | +npm install -g @harperfast/agent |
| 26 | +``` |
| 27 | + |
| 28 | +### Usage |
| 29 | + |
| 30 | +To start the agent, simply run: |
| 31 | + |
| 32 | +```bash |
| 33 | +harper-agent |
| 34 | +``` |
| 35 | + |
| 36 | +On first run, it will help you configure your preferred AI model (Gemini, Claude, ChatGPT, or Ollama). Once configured, you can interact with it directly from your terminal. |
| 37 | + |
| 38 | +--- |
| 39 | + |
| 40 | +## Skills: Empowering General-Purpose Agents |
| 41 | + |
| 42 | +If you prefer using general-purpose AI tools like **Claude**, **ChatGPT**, **GitHub Copilot**, or **Cursor**, you can provide them with Harper-specific "Skills" to improve their accuracy and performance. |
| 43 | + |
| 44 | +### What are Skills? |
| 45 | + |
| 46 | +Skills are a collection of Harper-specific context, documentation, and best practices. When an AI agent has access to these skills, it is much more likely to generate high-quality, idiomatic Harper code and follow current best practices. |
| 47 | + |
| 48 | +### Getting Skills |
| 49 | + |
| 50 | +The easiest way to get Harper skills is by using the `create-harper` bootstrapper. When you create a new Harper project, a `skills/` directory is automatically included. |
| 51 | + |
| 52 | +```bash |
| 53 | +npm create harper@latest |
| 54 | +``` |
| 55 | + |
| 56 | +You can also browse our ever evolving library of skills here: |
| 57 | + |
| 58 | +https://github.com/HarperFast/create-harper/tree/main/templates-shared/all/skills |
| 59 | + |
| 60 | +### How to use Skills |
| 61 | + |
| 62 | +Once you have a `skills/` directory in your project, you can use it with your favorite AI tools: |
| 63 | + |
| 64 | +- **Chat-based AI (Claude/ChatGPT)**: Upload the markdown files from the `skills/` directory to your conversation to provide the AI with immediate context. |
| 65 | +- **IDE Extensions (Cursor/Copilot)**: Ensure these tools are indexing your project. They will automatically pick up the context from the `skills/` directory to provide better completions and chat responses. |
| 66 | +- **Custom Agents**: If you are building your own AI-powered workflows, you can point your agent to these skills to give it specialized knowledge of Harper. |
| 67 | + |
| 68 | +By leveraging these AI tools, you can move from idea to a running Harper application faster than ever before. |
0 commit comments