0 Fork 0

mirror of https://github.com/proxysoul/Empryo.git synced 2026-11-07 06:25:57 -10:00

Files

T

Eugene Kravets 0da933fdee Load instruction files from the home directory (#49 )

## Summary
This fixes a gap in instruction loading: `instructionFiles` could be
enabled globally, but the loader still only looked in the repo root.

This change:
- loads enabled instruction sources from both the project directory and
the user's home directory
- keeps both project and global instructions in the prompt and makes
global precedence explicit when both exist
- adds targeted loader tests and updates the docs for prompt assembly,
config, and headless behavior

## Testing
- `bun test tests/instructions-loader.test.ts tests/shiki-marked.test.ts
tests/prompt-builder.test.ts`
- `bunx biome check src/core/instructions.ts
tests/instructions-loader.test.ts`

2026-04-20 23:03:18 +02:00

2.6 KiB

Raw Permalink Blame History

SoulForge

Graph-powered code intelligence — multi-agent coding with codebase-aware AI.

Platform

macOS (ARM64, x64) and Linux (x64, ARM64). No native Windows support — use WSL.

Stack

Runtime: Bun (not Node.js)
Language: TypeScript (strict mode)
TUI: OpenTUI (React for terminal UIs)
LLM: Vercel AI SDK (multi-provider)
Editor: Neovim (embedded via msgpack-RPC)
Linter/Formatter: Biome

Commands

bun run dev — start soulforge
bun run lint — lint with biome
bun run lint:fix — auto-fix lint issues
bun run format — format with biome
bun run typecheck — check types

CLI Flags

--session <id> / --resume <id> / -s <id> — resume a saved session
--headless <prompt> — run without TUI, stream to stdout
--headless --json — structured JSON after completion
--headless --events — JSONL event stream (real-time)
--headless --model <provider/model> — override model
--headless --mode <mode> — set mode (default/architect/plan/auto)
--headless --system "..." — inject system prompt
--headless --include <file> — pre-load file into context (repeatable)
--headless --session <id> — resume a previous session
--headless --save-session — save session after completion
--headless --max-steps <n> — limit agent steps
--headless --timeout <ms> — abort after timeout
--headless --no-repomap — skip repo map scan (deprecated: use SOULFORGE_NO_REPOMAP=1 env var)
--headless --diff — show files changed after run
--headless --quiet / -q — suppress header/footer
--headless --cwd <dir> — set working directory
--headless --chat — interactive multi-turn chat (auto-saves session on exit)
--list-providers — show providers and key status
--list-models [provider] — show available models
--set-key <provider> <key> — save API key
--version / -v — show version
--help / -h — show usage
Piped input: echo "prompt" | soulforge --headless
Exit codes: 0=success, 1=error, 2=timeout, 130=abort
Custom providers: add providers array to config (OpenAI-compatible APIs)
Project instructions: enabled sources load from the project root and matching home-scoped files; SOULFORGE.md / ~/.soulforge/instructions.md are on by default and CLAUDE.md + others are available via /instructions

Conventions

Use bun instead of node, npm, npx
Use Biome for linting + formatting (not ESLint/Prettier)
Strict TypeScript — no any, no unused vars
React JSX transform (no import React needed)

2.6 KiB Raw Permalink Blame History