User Guide

This section covers day-to-day usage of NubiferOS, including workspace management, credential handling, and security features.

Workspaces

Workspaces are isolated environments for different cloud accounts. Each workspace has its own:

• Credentials (stored encrypted)
• Environment variables
• Shell history
• Visual indicators

# Create a workspace
nubifer-workspace create --name aws-prod --provider aws

# Switch workspaces
nubifer-workspace switch aws-prod

# List workspaces
nubifer-workspace list

Learn more: Workspace Isolation

Credential Management

NubiferOS uses pass (the standard Unix password manager) with GPG encryption to store your cloud credentials securely.

# Add credentials
nubifer-creds add

# List credentials
nubifer-creds list

# Use AWS SSO (recommended)
nubifer-creds aws configure-sso

Learn more: Credential Security

Context Indicators

Visual feedback helps you always know which workspace is active:

• Terminal prompt shows workspace name and region
• GNOME panel indicator
• Desktop wallpaper can change per workspace

Source: Context Indicator Component

Read-Only Mode

Lock workspaces to prevent destructive operations like terraform destroy. Enabling write mode requires sudo, creating an intentional barrier.

# Lock workspace
nubifer-workspace ro

# Unlock (requires sudo)
sudo nubifer-workspace rw

# Timed unlock (auto-reverts)
sudo nubifer-workspace rw -d 30

Learn more: Workspace Isolation - Read-Only Mode

NubiferAI Integration

NubiferAI is an AI-native cloud operations platform that integrates with NubiferOS workspaces. Describe what you want to build or deploy in natural language and get infrastructure-as-code.

• NubiferAI Overview — What it is and how it works
• Getting Started with NubiferAI — Installation and first nucleation
• NubiferOS Integration — How NubiferAI uses your workspaces and credentials