francy51
0624026af3
Replace the custom Pi API fetch client with the @earendil-works/pi-coding-agent SDK, enabling support for multiple LLM providers (Anthropic, OpenAI, DeepSeek, Google Gemini, xAI/ZAI) while maintaining backward compatibility. Key changes: - Add piSdk.ts with SDK session management and provider auto-detection - Refactor client.ts to delegate to SDK adapter, keeping public API surface - Update documentation to reflect multi-provider environment variables - Add RPC contracts for LLM model selection and provider configuration - Update agent runner to support provider-specific tools and parameters Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2.3 KiB
2.3 KiB
MosaicIQ - Claude Code Instructions
This is the primary instruction file for Claude Code working on the MosaicIQ project.
Quick Start
Required:
export ANTHROPIC_API_KEY=sk-ant-...
# or another supported provider:
# export OPENAI_API_KEY=sk-...
# export DEEPSEEK_API_KEY=...
# export GOOGLE_API_KEY=...
# export ZAI_API_KEY=...
See agent.md for complete project documentation, including:
- Full LLM Client Reference with all Pi API functions
- Monorepo structure and key files
- Agent behavior guidelines
- Implementation priorities
- Coding style and architecture rules
Project Overview
MosaicIQ is an AI-native equity research workspace built as a local-first desktop application.
- Stack: TypeScript, React, Electron, SQLite
- Architecture: t3-code-style with typed RPC layer
- LLM: Pi API (Inflection AI) for all AI operations
- Monorepo: PNPM workspace with apps (desktop, web) and shared packages
Dev Server Rules
NEVER start, stop, restart, or manage the dev server. The user runs the app independently. Your job is to write/edit code and run verification commands (typecheck, lint, tests, build).
File Structure
local_research_app/
├── apps/
│ ├── desktop/ # Electron main (RPC server, file I/O, DB, agents)
│ └── web/ # React UI (client)
├── packages/
│ ├── contracts/ # Shared TypeScript types
│ └── shared/ # Shared utilities, LLM client, agents, DB, export
├── agent.md # Complete project documentation
└── CLAUDE.md # This file
Key Links
| Topic | File |
|---|---|
| Full Documentation | agent.md |
| LLM Client Reference | agent.md # LLM Client Reference |
| Architecture | docs/architecture.md |
| RPC Contracts | packages/contracts/src/rpc.ts |
| LLM Client | packages/shared/src/llm/piSdk.ts |
Coding Style
- TypeScript throughout
- Small, readable components
- Explicit state and typed contracts
- No unnecessary abstractions
- Follow design tokens from design doc
- Intentional empty/loading/error states
When Unsure
Default to agent.md or the MosaicIQ Design Document v3 (attached separately).