Shortcuts & Tips

This page covers keyboard shortcuts and practical tips for using ProjectHub faster and more efficiently.

Keyboard Shortcuts

Global Shortcuts

These shortcuts are available anywhere in the app:

Shortcut	Action
`Cmd+D`	Open / view Dashboard
`Cmd+T`	Toggle integrated terminal
`Cmd+N`	Create new project
`ESC`	Close current sheet/modal

Project View Shortcuts

Shortcut	Action
`Cmd+T`	Toggle terminal panel
`Cmd+S`	Create snapshot (in the Snapshots tab)

Shortcut	Action
`Return`	Confirm / Save
`Cmd+Return`	Confirm / Save (in long text fields)
`ESC`	Cancel / Close

Schedule Management Shortcuts

Shortcut	Action
`Cmd+Return`	Save event
`ESC`	Cancel / Close

AI Task Shortcuts

Shortcut	Action
`Y`	Yes (in confirmation dialogs)
`N`	No (in confirmation dialogs)

Tips & Best Practices

Choosing the Right AI Feature

A guide to help you decide which AI feature to use:

Interactive coding / debugging  -> Vibe Coding (real-time AI terminal)
Automated project generation    -> AI Agent (6-stage autonomous pipeline)
Feature / module development    -> Avalon3 (debate + implementation)
Code review / analysis          -> Colligi (collective intelligence)
Full project development        -> Alliance (7-phase workflow)

Task Scale	Recommended Tool	Reason
Exploration / debugging	Vibe Coding	Real-time conversation with AI
Function~file auto-generation	AI Agent	Automated via autonomous pipeline
Module / feature	Avalon3	Debate improves quality
Analysis / review	Colligi	Multi-perspective analysis
Entire project	Alliance	Systematic workflow

Writing Effective AI Prompts

1. Be specific

Bad:  "Build me an app"
Good: "Build a TODO REST API with Python FastAPI. Include SQLite DB, JWT authentication, and Swagger docs."

2. Specify the tech stack

Bad:  "Build me a website"
Good: "Build a portfolio website with Next.js 14 + TypeScript + Tailwind CSS."

3. List out the features

Good: "I need the following features:
User sign-up / login
Profile editing
Post CRUD
Comment functionality
Image upload"

4. Break complex projects into steps

Step 1: "Create the basic project structure and DB schema"
Step 2: "Add the authentication system"
Step 3: "Build the post CRUD API"
Step 4: "Build the frontend"

Snapshot Strategies

When	Action
Before AI code generation	Automatic backup (if configured)
Before major changes	Create a manual snapshot
When a feature is complete	Milestone snapshot (with notes)
Before experimenting	Restore-point snapshot

Project Organization Tips

Using groups:

By client: "Client A", "Client B"
By type: "Web Projects", "CLI Tools", "Libraries"
By status: "In Progress", "Completed", "Archived"

Using filters:

Use the "In Development" filter to show only active projects
Use the "Archived" filter to view completed projects

Terminal Tips

Running AI CLIs directly:

# Quick question with Claude Code
claude "What is the time complexity of this function?"
Code review with Gemini
gemini "Review the code in the src/ folder"
Resume a previous session
claude --resume

Multitasking:

Use the ProjectHub terminal for your main task
Use "Open in System Terminal" for additional terminals
Run servers, tests, and builds in parallel

Colligi Analysis Tips

Good analysis topics:

"Evaluate the architecture of this project"
"Find security vulnerabilities"
"PostgreSQL vs MongoDB -- which is more suitable for this project?"
"Suggest a test coverage strategy for this code"

Setting the maximum rounds:

Simple topics: 1--2 rounds
Complex topics: 3--5 rounds
More rounds = higher convergence, but longer processing time

Alliance Workflow Tips

Making the most of Human Checkpoints:

Carefully review the AI's debate results at P0
Choosing directions manually instead of using autonomous mode yields more accurate outcomes

Leveraging phase documents:

Reviewing P1 design documents beforehand improves P3 implementation quality
When P4 audit fails, review the issues and provide additional guidance

FAQ

Q: I'm not happy with the AI-generated code

A: Restore from a snapshot, refine your prompt to be more specific, and try again. The AI Agent does not reference previous attempts, so each run starts fresh.

Q: What AI combination works best in Avalon3?

A: Setting Claude as the Synthesizer and using a variety of AIs as Debaters tends to produce the most balanced results.

Q: Ollama is slow

A: Ollama runs locally and heavily depends on your hardware. Apple Silicon M1 Pro or better is recommended. Start with smaller models (7B) first.

Q: Snapshots are taking up too much space

A: Add node_modules, build, dist, and similar directories to .gitignore before creating snapshots to reduce their size. Periodically delete old snapshots.

Q: P2P connection isn't working

A: Check your firewall settings and make sure network access permissions are granted. Both devices must be on the same local network.

Next Steps

Getting Started -- Start from scratch
Project Management -- Project management guide
AI Agent -- AI code generation guide