Skip to content

AGENTS.md

Latest commit

 

History

History
69 lines (42 loc) · 2.56 KB

AGENTS.md

File metadata and controls

69 lines (42 loc) · 2.56 KB

AGENTS

This repository uses main as the primary branch.

Project

Lilo is a monorepo with:

  • frontend/: React + Vite + TypeScript + Tailwind + Zustand chat UI.
  • backend/: Hono + TypeScript server that uses the Pi SDK for persistent multi-session chats and streams events to the frontend via SSE.

Frontend Preferences

  • Favor small components.
  • Put each component in its own file.
  • Keep everything organized well into directories.

Configuration

  • Keep runtime/build configuration centralized.
  • Backend code should read environment-backed values through backend/src/shared/config/config.ts; do not read process.env directly from routes, services, or tools.
  • Frontend code should read Vite env-backed values through frontend/src/config/config.ts; do not read import.meta.env directly from components, hooks, stores, or libs.
  • If a new env var is needed, add it to the appropriate config.ts first, then consume it from there.

Open Source Privacy

  • This is an open source project. Avoid committing sensitive or author-specific information, including personal deployment URLs, private Lilo server URLs, workspace names, phone numbers, email addresses, API keys, tokens, or local filesystem details.
  • Keep examples, app entitlements, deep-link domains, docs, tests, and defaults generic or configurable. Do not hard-code details from an author's own Lilo setup unless the user explicitly asks for a local-only experiment and the change will not be committed/shared.

Coding Agent

The coding agent used in this product is Pi Mono:

When changing Pi SDK integration code in this repo, use the Pi SDK docs above as the primary reference for supported session options and APIs.

Reference Implementations

When asked how a feature is implemented, or to compare Lilo's implementation to Hermes or OpenClaw, consult these docs for details:

Local Development

  • Never edit .env directly.

From the repo root:

pnpm install
pnpm run dev:backend
pnpm run dev:frontend

Default local URLs:

  • Frontend: http://localhost:5800
  • Backend: http://localhost:8787

Workspace apps should be opened over HTTP via:

  • http://localhost:8787/workspace/<app-name>

Agent Runtime

The backend runs Pi sessions through the Pi SDK and translates agent events into SSE events for the frontend.