Managing Projects

Efficiently manage your projects within each space. Switch contexts instantly, keep work organized, and maintain a clean project list.

Viewing projects

Access project list

See all projects for a space:

1. Connect to your space
2. Tap the project name in the header
3. View all available projects
4. See recent projects first

Project information

Each project shows:

• Name - Your chosen identifier
• Path - Location on the server
• Last used - Recent access indicator
• Status - Current/active marker

Switching projects

Quick switch

Change your active project instantly:

1. Tap current project name
2. Select different project
3. Everything updates immediately:
   • Terminal changes directory
   • Editor updates context
   • File browser refreshes
   • Git status updates

No reconnection needed!

Keyboard shortcut

For faster switching:

• Use Cmd+P to open project picker
• Type to filter projects
• Enter to switch

From recent list

Access frequently used projects:

• Recent projects shown first
• Last 5 projects always visible
• Tap to switch immediately

Organizing projects

Rename projects

Update project names for clarity:

1. Long-press project entry
2. Select Rename
3. Enter new name
4. Path remains unchanged

Reorder projects

Customize your project order:

• Recent projects auto-sort by usage
• Manual ordering available
• Drag to reorder
• Pin important projects

Remove projects

Clean up unused projects:

1. Swipe left on project
2. Tap Remove
3. Confirms before removing
4. Files remain on server

Note: Removing only removes the reference, not the actual folder.

Recent projects

How it works

Kisuke tracks your usage:

• Updates on each access
• Shows last 5 projects
• Sorted by recency
• Synced across devices

Quick access

From the main screen:

• Recent tab shows frequently used
• One tap to load
• Reduces navigation time
• Builds working set naturally

Clear recent

Reset your recent list:

1. Long-press on recent project
2. Select Clear Recent
3. Project remains in full list
4. Recent history reset

Project status

Active project

The current working project:

• Shown in header
• Marked in project list
• Terminal working directory
• Editor default path

Project availability

Status indicators:

• ✓ Available - Ready to use
• ⚠️ Missing - Folder not found
• 🔒 No access - Permission denied
• 🔄 Checking - Verifying status

Bulk operations

Select multiple

Manage several projects:

1. Tap Edit in project list
2. Select multiple projects
3. Choose action:
   • Remove selected
   • Export list
   • Share configuration

Export project list

Share your setup:

1. Select projects to export
2. Choose format (JSON/Text)
3. Share via:
   • AirDrop
   • Messages
   • Email
   • Files

Import projects

Add projects from export:

1. Receive project list
2. Tap to import
3. Review projects
4. Add all or select specific

Search and filter

Search projects

Find projects quickly:

• Search by name
• Search by path
• Instant results
• Clear search easily

Filter options

Narrow your view:

• Recent only - Last accessed
• By name - Alphabetical
• By path - Directory grouped
• Custom filters - Your criteria

Project templates

Save as template

Create reusable structures:

1. Set up project perfectly
2. Save as template
3. Name your template
4. Reuse for new projects

Apply template

Use saved structures:

1. Create new project
2. Choose template
3. Customize as needed
4. Consistent setup

Best practices

Naming conventions

Use clear, consistent names:

• Purpose-based: blog-posts, api-server
• Client-based: acme-website, bigco-app
• Date-based: archive-2023, q4-reports

Regular maintenance

Keep projects organized:

• Remove completed projects
• Update names as needed
• Archive old work
• Review quarterly

Project limits

Performance considerations:

• Optimal: 10-20 projects per space
• Maximum: 100 projects per space
• Archive unused projects
• Group related work

Troubleshooting

Project won’t switch

Terminal doesn’t update:

• Check connection status
• Verify project exists
• Try reconnecting
• Check permissions

Editor shows wrong files:

• Refresh file browser
• Check project path
• Clear editor cache

Missing projects

Project disappeared:

• Check if folder was moved
• Verify SSH permissions
• Re-add if necessary
• Check recent deletions

Can’t see project:

• Check filter settings
• Clear search field
• Scroll full list
• Verify it was added

Performance issues

Slow project switching:

• Reduce project count
• Check network speed
• Clear app cache
• Update Kisuke

Tips and tricks

Quick workflows

Morning routine:

1. Open Kisuke
2. Recent projects ready
3. Tap to resume work
4. Context restored instantly

Client juggling:

1. Group projects by client
2. Switch contexts quickly
3. Keep work separated
4. Bill time accurately

Learning setup:

1. Create learning projects
2. Organize by topic
3. Track progress
4. Archive when complete

Next steps

• Adding projects →
• Space management →