A space is a data ownership container in TinyCloud. Each space is tied to a user identity and isolates data between applications. The tc space commands let you create, list, inspect, and switch between spaces.
What is a Space?
Every piece of data in TinyCloud lives inside a space. When you sign in, a space is automatically created for your profile. Spaces are identified by a URI combining the protocol, your identity, and a space name:
tinycloud:pkh:eip155:{chainId}:{address}:{spaceName}
tinycloud:pkh:eip155:1:0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045:my-app
Spaces isolate data between applications. The same wallet can have separate spaces for different apps, and data in one space is not accessible from another.
Commands
tc space list
List all spaces associated with your identity.
$ tc space list
Spaces for 0xd8dA...6045:
* tinycloud:pkh:eip155:1:0xd8dA...6045:default (active)
tinycloud:pkh:eip155:1:0xd8dA...6045:my-app
tinycloud:pkh:eip155:1:0xd8dA...6045:staging
3 spaces total
$ tc space list --json
{
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"activeSpaceId": "tinycloud:pkh:eip155:1:0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045:default",
"spaces": [
{
"spaceId": "tinycloud:pkh:eip155:1:0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045:default",
"name": "default",
"active": true
},
{
"spaceId": "tinycloud:pkh:eip155:1:0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045:my-app",
"name": "my-app",
"active": false
},
{
"spaceId": "tinycloud:pkh:eip155:1:0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045:staging",
"name": "staging",
"active": false
}
],
"count": 3
}
tc space create
Create a new space.
$ tc space create my-app
Space created: tinycloud:pkh:eip155:1:0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045:my-app
$ tc space create my-app --json
{
"spaceId": "tinycloud:pkh:eip155:1:0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045:my-app",
"name": "my-app",
"created": true
}
tc space info
Show details about a space.
If no space ID is given, shows information about the active space.
$ tc space info
Space: tinycloud:pkh:eip155:1:0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045:default
Name: default
Address: 0xd8dA...6045
Chain: 1 (mainnet)
Keys: 42
Created: 2026-01-15T08:00:00.000Z
$ tc space info --json
{
"spaceId": "tinycloud:pkh:eip155:1:0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045:default",
"name": "default",
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"chainId": 1,
"keyCount": 42,
"createdAt": "2026-01-15T08:00:00.000Z"
}
tc space switch
Switch the active space for the current profile.
tc space switch <space-id>
$ tc space switch tinycloud:pkh:eip155:1:0xd8dA...6045:my-app
Switched to space: tinycloud:pkh:eip155:1:0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045:my-app
tc kv commands operate on the new active space.
Working with Multiple Spaces
A common pattern is to use different spaces for different environments or applications:
# Create spaces for different environments
tc space create production
tc space create staging
# Work in staging
tc space switch tinycloud:pkh:eip155:1:0xd8dA...6045:staging
tc kv put config/feature-flag '{"newUI": true}'
# Switch to production
tc space switch tinycloud:pkh:eip155:1:0xd8dA...6045:production
tc kv put config/feature-flag '{"newUI": false}'
Combine spaces with profiles to manage completely separate identities and environments. 
