Skip to content

PIE Agent DocsBuild agents for Personal Intelligence Engine

Create Skills, Tools, Widgets, Public Apps, OAuth Connectors, and Automations that extend PIE's capabilities

LLM-Friendly Docs ​

These docs are optimized for AI coding assistants like Cursor, Copilot, and Claude. Copy a link below and paste it into your AI assistant's context:

DocumentDescriptionLink
llms.txtCurated documentation index/docs/llms.txt
llms-full.txtComplete docs in one file (paste into AI)/docs/llms-full.txt
Complete ReferenceSingle-page Markdown referenceView Reference

Every page also has a "Copy for LLMs" button in the bottom-right corner.

Build Public Apps ​

Need a shareable frontend at a real URL? PIE plugins can ship public pages from the same .pie file you already use for tools and widgets.

  • Serve pages at /apps/{pluginSlug}/{instanceSlug}/...
  • Add SPA fallback routes with ===public-config===
  • Call plugin code from the browser with /api/public-actions/{instanceId}/{actionId}
  • Map a custom domain after verification

Start with Your First Public App for a hands-on build, then use the Public Apps and Routes guide as the reference.

Quick Start ​

Create a simple weather tool in under 5 minutes:

js
async function handler(input, context) {
  const { city } = input;
  const apiKey = context.secrets.WEATHER_API_KEY;
  
  const response = await context.fetch(
    `https://api.weatherapi.com/v1/current.json?key=${apiKey}&q=${city}`
  );
  
  if (!response.ok) {
    return { error: true, message: 'Failed to fetch weather' };
  }
  
  const data = JSON.parse(response.body);
  return {
    city: data.location.name,
    temperature: data.current.temp_c,
    condition: data.current.condition.text,
  };
}

module.exports = { handler };

Agent Types ​

TypeTriggerDescription
SkillAlways activeCustom prompts added to every conversation
ToolAuto (AI decides)Functions the AI can call when needed
ConnectorAutoTools with OAuth integration
AutomationCron / WebhookBackground tasks with AI capabilities

Built with VitePress