Skip to main content

​
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

​
Step 1: Project Initialization

​
1.1 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

​
1.2 Initialize Trellis

trellis init
trellis init

​
1.3 Copy Specs from Existing Project

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

​
1.4 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

​
Step 2: Task Planning

​
2.1 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

​
2.2 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

​
2.3 Complete Batch 1

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

​
Step 3: Parallel Development

​
3.1 Start Parallel Agents

Prompt: /trellis:parallel AI launches 3 worktree agents for Batch 2, each working in an isolated git worktree: parallel agents

​
Step 4: Monitor Progress

​
4.1 Check Agent Status

AI monitors agent status and task progress: agent status

​
4.2 Record Session

After parallel agents complete, they create PRs automatically: parallel PRs After merging and completing a batch, record the session: Prompt: /trellis:record-session record session

​
Step 5: Continue Development

​
5.1 Check Remaining Tasks

AI shows remaining tasks in the current project: task list

​
5.2 Implement Next Feature

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

​
5.3 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 development/trellis:parallel, worktree agents
4Monitor & record/trellis:record-session
5Continue iteratingTask hooks, implement/check agents
Result: Complete Electron app in 1 day, with structured specs and documented progress.