Listing Spaces¶

The thothctl list spaces command allows you to view all spaces that are managed by ThothCTL. This helps you understand how your projects are organized and which spaces are available for new projects.

Command Syntax¶

thothctl list spaces [OPTIONS]

Options¶

Basic Usage¶

Listing All Spaces¶

To list all spaces managed by ThothCTL:

thothctl list spaces

Example output:

                         🌌 Space List                          
┏━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ SpaceName        ┃ Projects   ┃ Description                  ┃
┡━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ 🌐 dev           │ 3 projects │ Development environment       │
├──────────────────┼────────────┼──────────────────────────────┤
│ 🌐 staging       │ 2 projects │ Staging environment          │
├──────────────────┼────────────┼──────────────────────────────┤
│ 🌐 production    │ 1 projects │ Production environment       │
└──────────────────┴────────────┴──────────────────────────────┘

Understanding the Output¶

The space list output includes the following information:

• SpaceName: The name of the space
• Projects: The number of projects associated with the space
• Description: A description of the space's purpose

Spaces are marked with a globe icon (🌐) to indicate they are spaces managed by ThothCTL.

Filtering Spaces¶

While ThothCTL doesn't provide built-in filtering options for the list command, you can combine it with standard command-line tools to filter the output:

# List spaces and filter by name using grep
thothctl list spaces | grep "dev"

# List spaces with specific project counts
thothctl list spaces | grep "0 projects"

Use Cases¶

Space Management¶

Use the list command to maintain an overview of all your spaces:

# Generate a list of all spaces
thothctl list spaces > spaces_inventory.txt

Space Organization¶

Identify which spaces have many or few projects:

# List all spaces to review organization
thothctl list spaces

Space Cleanup¶

Identify empty spaces that might need cleanup:

# List spaces with no projects
thothctl list spaces | grep "0 projects"

Team Collaboration¶

Share information about available spaces with team members:

# Generate a formatted list of spaces
thothctl list spaces

Best Practices¶

1. Regular Review: Periodically review your space list to identify unused or outdated spaces
2. Meaningful Descriptions: Ensure each space has a clear and meaningful description
3. Logical Organization: Group related projects within appropriate spaces
4. Clean Up: Remove spaces that are no longer needed using the remove space command

Related Commands¶

• thothctl init space - Create a new space
• thothctl remove space - Remove an existing space
• thothctl init project --space <space-name> - Create a project in a specific space