Skip to content
Prompt

theia-cli — Copilot Instructions

by vyricon

AI Summary

TheiaChat CLI Copilot Instructions is a comprehensive governance framework for an AI-assisted TypeScript terminal tool, designed to enforce enterprise-grade code quality, security, and architectural rigor through mandatory PRD-first workflows and triple-check verification gates. Enterprise teams and AI coding agents working on TypeScript CLI projects benefit from its structured approach to secure, validated feature development.

Install

Copy this and paste it into Claude Code, Cursor, or any AI assistant:

I want to add the "theia-cli — Copilot Instructions" prompt rules to my project.
Repository: https://github.com/vyricon/theia-cli

Please read the repo to find the rules/prompt file, then:
1. Download it to the correct location (.cursorrules, .windsurfrules, .github/prompts/, or project root — based on the file type)
2. If there's an existing rules file, merge the new rules in rather than overwriting
3. Confirm what was added

Description

TheiaChat CLI is a TypeScript-first terminal assistant built with Multiple model supported and Supabase Postgres + pgvector for permanent semantic memory. It supports streaming chat, tool calling, and retrieval-augmented prompts, designed for enterprise use with strict input validation and secure configuration.

1) Requirements (MUST)

• MUST use Vercel AI SDK v5+ APIs/patterns. MUST NOT introduce v4-era helpers. • MUST route all LLM + embeddings through Vercel AI Gateway. MUST NOT call provider endpoints directly. • MUST implement semantic memory using Supabase Postgres + pgvector with HNSW index. • MUST scope all persisted memory by a personal user_id (stable local id). MUST filter every memory query by user_id. • MUST validate CLI args/flags, env vars, and tool inputs via Zod at boundaries. • MUST use TypeScript strict with NO any. • MUST use npm only. • MUST include robust error handling (actionable messages, correct exit codes, no secret leakage).

2) Project overview

TheiaChat CLI is a TypeScript-based CLI that helps users interact with TheiaChat and associated AI infrastructure from terminals and scripts. Typical capabilities: • Authenticate/configure a user profile. • Send prompts and display AI responses. • Stream responses for interactive usage. • Integrate with corporate AI routing (AI Gateway) and retrieval (Supabase + pgvector). -USer have Github enterprise License with access to all models, integrate if possible. ---

Copilot Coding Agent Instructions (TheiaChat CLI)

> Repository: theia-cli > Product: TheiaChat CLI (a Node.js/TypeScript command-line tool for interacting with TheiaChat and related AI services) > Audience: GitHub Copilot Coding Agent working in this repo These instructions define corporate/professional protocol for automated changes in this repository. They incorporate guidance from https://gh.io/copilot-coding-agent-tips. ---

0.1 PRD-first workflow (MUST)

For any non-trivial change (new feature, multi-file edit, DB changes, AI integration), the agent MUST produce a PRD and TODO list BEFORE implementing code. PRD MUST include: • Problem statement + goals • Non-goals • User stories / CLI UX examples (exact commands + expected outputs) • Architecture overview (CLI layer, Core layer, DB layer) • Data model (tables, indexes, key fields, constraints) • Security considerations (secrets, redaction, safe tool defaults) • Failure modes + handling (timeouts, rate limits, DB down, invalid env) • Acceptance criteria (testable checkboxes) TODO list MUST be: • Specific, file-oriented, checkable • Includes migrations + docs updates + tests

Discussion

0/2000
Loading comments...

Health Signals

MaintenanceCommitted 3mo ago
Stale
AdoptionUnder 100 stars
0 ★ · Niche
DocsREADME + description
Well-documented

GitHub Signals

Issues4
Updated3mo ago
View on GitHub
Apache-2.0 License

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Any AI assistant that accepts custom rules or system prompts

Claude
ChatGPT
Cursor
Windsurf
Copilot
+ more