Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.trytrellis.app/llms.txt

Use this file to discover all available pages before exploring further.

​
open-typeless

A step-by-step tutorial showing how to use Trellis to build a macOS voice input app from scratch.
Source Code: github.com/mindfold-ai/open-typeless

​
Project Initialization

​
Create Electron Project

npx create-electron-app@latest open-typeless --template=vite-typescript

cd open-typeless

# Remove npm generated files
rm -rf node_modules package-lock.json

# Create .npmrc (required for pnpm + Electron)
cat > .npmrc << 'EOF'
node-linker=hoisted
shamefully-hoist=true
EOF

# Reinstall with pnpm
pnpm install

​
Initialize Trellis

trellis init
trellis init

​
Copy Specs from Existing Project

If you have specs from a similar project, copy them over: 
cp -r /path/to/old-project/.trellis/spec ./

​
Ask AI to Fill in Specs

Prompt:
Help me select useful specs from electron-doc/ and organize them into this project’s .trellis/spec/
AI will analyze and organize specs: spec selection

​
Task Planning

​
Ask AI to Plan Tasks

Prompt:
I want to use Volcengine ASR BigModel API to build this. Help me plan how to break down the tasks.
AI creates a batch-based task plan: task planning

​
Create Tasks

AI creates tasks organized into batches:
BatchTasksPurpose
Batch 1asr-infrastructureFoundation (must complete first)
Batch 2asr-audio-recorder, asr-volcengine-client, asr-floating-windowCan run in parallel
Batch 3asr-integrationIntegration (depends on Batch 2)
tasks created

​
Complete Batch 1

After Batch 1 completes, verify and update downstream task contexts: batch 1 complete

​
Parallel Development

​
Start Parallel Sessions

For current Trellis, create one Git worktree and one AI session for each Batch 2 task, then start the matching Trellis task inside that session. 
git worktree add ../asr-audio-recorder -b feature/asr-audio-recorder
git worktree add ../asr-volcengine-client -b feature/asr-volcengine-client
git worktree add ../asr-floating-window -b feature/asr-floating-window
Each session has its own active-task pointer, so starting a task in one session does not affect the others. parallel agents

​
Monitor Progress

​
Check Agent Status

AI monitors agent status and task progress: agent status

​
Record Session

After parallel sessions complete, review and merge each branch through your normal Git process: parallel PRs After merging and completing a batch, record the session: Prompt: /trellis:finish-work record session

​
Continue Development

​
Check Remaining Tasks

AI shows remaining tasks in the current project: task list

​
Implement Next Feature

Select the next task, AI uses trellis-implement sub-agent then trellis-check sub-agent: implement and check

​
Configure and Test

AI helps with remaining setup (environment config, permissions): final setup

​
Summary

Using Trellis to build open-typeless:
StepWhatTrellis Feature
1Initialize projecttrellis init, spec organization
2Plan tasksAI task breakdown, batch planning
3Parallel developmentNative Git worktrees + session-scoped Trellis tasks
4Monitor & record/trellis:finish-work
5Continue iteratingTask hooks, implement/trellis-check sub-agents
Result: Complete Electron app in 1 day, with structured specs and documented progress.