Adding Projects

Add project folders to your space to organize your work. Choose from automatic discovery, manual browsing, or direct path entry.

Quick start

After connecting to a space:

1. Tap Add Project or the + button
2. Choose how to add your project
3. Select or create your folder
4. Start working immediately

Discovery methods

Auto-discovery 🔍

Let Kisuke find projects for you:

1. Tap Search for Projects
2. Kisuke scans for common indicators:
   • Git repositories (.git)
   • Node.js projects (package.json)
   • Python projects (requirements.txt, setup.py)
   • Rust projects (Cargo.toml)
   • Go modules (go.mod)
   • And many more
3. Select projects to add
4. All selected projects added at once

Perfect for:

• Development machines with many repos
• Quick initial setup
• Finding forgotten projects

Browse manually 📁

Navigate and choose folders yourself:

1. Tap Browse Folders
2. Navigate through directories
3. Select any folder as a project
4. Tap to confirm selection

Perfect for:

• Custom folder structures
• Non-code directories
• Specific organization needs

Create new project ✨

Start fresh with a new folder:

1. Tap New Project
2. Enter project name
3. Choose parent directory
4. Kisuke creates the folder

Perfect for:

• Starting new work
• Organizing existing files
• Clean project structure

Add from path 📝

Know exactly where your project is?

1. Tap Add from Path
2. Enter the full path
3. Kisuke verifies and adds it

Examples:

/home/user/projects/my-app
/var/www/client-website
~/Documents/notes

Perfect for:

• Known locations
• Paths from documentation
• Quick precise adding

First project setup

When you connect to a new space:

1. Empty state appears - No projects yet
2. Choose your method - Discovery, browse, or create
3. Add your first project - Sets the working context
4. Ready to work - Terminal opens in project folder

Adding more projects

Add projects anytime:

From project list

1. Tap the + button
2. Choose discovery method
3. Add new projects

From quick actions

1. Long-press space entry
2. Select Add Project
3. Choose your method

While connected

1. Tap project name in header
2. Select Add Project
3. Continue working

Bulk adding

Add multiple projects at once:

1. Use Search for Projects
2. Kisuke finds all candidates
3. Select multiple with checkmarks
4. Tap Add Selected
5. All projects added together

Project validation

Kisuke verifies projects before adding:

• Existence check - Folder must exist
• Permission check - Must be readable
• Duplicate check - Can’t add same path twice
• Path validation - Must be valid directory

Tips for organization

Naming projects

Good project names:

• client-website not proj1
• learning-rust not test
• blog-2024 not new

Grouping strategies

By client:

• acme-frontend
• acme-backend
• acme-docs

By technology:

• react-apps
• python-scripts
• docker-configs

By status:

• active-development
• maintenance-only
• archived-2023

Common scenarios

”I have many repositories”

Use auto-discovery:

1. Tap Search for Projects
2. Wait for scan to complete
3. Review found projects
4. Select all you want
5. Add in one go

”My projects are scattered”

Combine methods:

1. Start with auto-discovery
2. Browse for missed folders
3. Add specific paths
4. Build your complete list

”I’m starting fresh”

Create organized structure:

1. Create new project folders
2. Name them clearly
3. Group related work
4. Stay organized from the start

Troubleshooting

Can’t find projects

Auto-discovery missing folders:

• Not all folders have indicators
• Use browse or path method instead
• Check folder permissions

Browse not showing folders:

• Hidden folders need explicit navigation
• Use path method for .folders
• Check SSH user permissions

Can’t add project

“Folder not found”:

• Verify path is correct
• Check for typos
• Use absolute paths

“Already added”:

• Project exists with different name
• Check your project list
• Remove old entry first

Next steps

• Managing projects →
• Switching projects →