Skip to content

profiles.md

Latest commit

 

History

History
370 lines (251 loc) · 8.29 KB

profiles.md

File metadata and controls

370 lines (251 loc) · 8.29 KB
Raw

Profile System

A.R.C. CLI includes a powerful profile system that lets you customize tier naming throughout the interface. Choose from 10 themed profiles or create your own custom profiles.

Quick Start

# List all available profiles
arc config list-profiles

# Set a profile
arc config set-profile jedi

# Show current profile
arc config get-profile

What are Profiles?

Profiles control how tier names are displayed throughout the A.R.C. CLI. When you select a profile, tier names change to match the theme:

  • Tier 1 (lowest/basic tier)
  • Tier 2 (middle/standard tier)
  • Tier 3 (highest/premium tier)

For example, with the jedi profile:

  • Tier 1 = Padawan
  • Tier 2 = Knight
  • Tier 3 = Master

With the saiyan profile:

  • Tier 1 = Super Saiyan
  • Tier 2 = Super Saiyan Blue
  • Tier 3 = Ultra Instinct

Built-in Profiles

A.R.C. CLI includes 10 themed profiles with custom ASCII logos and tier names:

1. Enterprise (Default)

Theme: Professional corporate naming for business environments

Tier Names:

  • Tier 1: Starter
  • Tier 2: Pro
  • Tier 3: Ultra

Color Theme: Cyan-Purple (professional blues and purples)

Use Case: Business environments, professional demos, corporate presentations

2. Saiyan

Theme: Dragon Ball Z transformation levels for power users

Tier Names:

  • Tier 1: Super Saiyan
  • Tier 2: Super Saiyan Blue
  • Tier 3: Ultra Instinct

Color Theme: Fire (bold oranges and reds)

Use Case: High-performance computing, power users, anime fans

3. Shinobi

Theme: Naruto ninja ranks for stealth and precision

Tier Names:

  • Tier 1: Genin
  • Tier 2: Jonin
  • Tier 3: Hokage

Color Theme: Gruvbox (earthy browns and oranges)

Use Case: Security teams, DevOps ninjas, anime enthusiasts

4. Pirate

Theme: One Piece pirate ranks for adventurous crews

Tier Names:

  • Tier 1: Rookie
  • Tier 2: Supernova
  • Tier 3: Yonko

Color Theme: Ocean (deep blues and teals)

Use Case: Startups, adventure-driven teams, sailing the technical seas

5. Pokemon

Theme: Pokemon evolution stages for trainers

Tier Names:

  • Tier 1: Basic
  • Tier 2: Stage 1
  • Tier 3: Stage 2

Color Theme: Rainbow (bright multi-color palette)

Use Case: Gaming teams, playful environments, Pokemon fans

6. Triforce

Theme: Legend of Zelda virtues for heroes

Tier Names:

  • Tier 1: Courage
  • Tier 2: Wisdom
  • Tier 3: Power

Color Theme: Solarized (balanced warm/cool tones)

Use Case: Adventure seekers, Zelda fans, balanced teams

7. Crystal

Theme: Final Fantasy job classes for warriors

Tier Names:

  • Tier 1: Warrior
  • Tier 2: Knight
  • Tier 3: Paladin

Color Theme: Monokai (rich purples and pinks)

Use Case: RPG fans, fantasy enthusiasts, Final Fantasy lovers

8. Jedi

Theme: Star Wars Force user ranks for sci-fi enthusiasts

Tier Names:

  • Tier 1: Padawan
  • Tier 2: Knight
  • Tier 3: Master

Color Theme: Nord (cool blues and grays)

Use Case: Sci-fi teams, Star Wars fans, Force-sensitive developers

9. Bending

Theme: Avatar: The Last Airbender mastery levels

Tier Names:

  • Tier 1: Bender
  • Tier 2: Avatar
  • Tier 3: Cosmic

Color Theme: Rainbow (elemental color spectrum)

Use Case: Element enthusiasts, Avatar fans, balanced teams

10. Horcrux

Theme: Harry Potter wizard ranks for magical teams

Tier Names:

  • Tier 1: Student
  • Tier 2: Auror
  • Tier 3: Headmaster

Color Theme: Dracula (dark purples and reds)

Use Case: Wizarding teams, Harry Potter fans, magical environments

Commands

`arc config list-profiles`

Lists all available profiles with their descriptions and tier names.

The `▶` marker indicates your currently active profile.

`arc config set-profile `

Sets and persists the profile:

arc config set-profile jedi
# ✅ Profile set to: jedi

The profile is saved to `~/.arc/state.json` and persists across:

  • Terminal sessions
  • System reboots
  • All `arc` commands

`arc config get-profile`

Displays the currently active profile with details.

Profile Persistence

Profiles are saved to `~/.arc/state.json` and persist across:

  • Terminal sessions
  • System reboots
  • All `arc` commands
  • Workspace operations

Reset to default:

arc config set-profile enterprise

Creating Custom Profiles

You can create your own custom profiles with personalized tier names, logos, and themes.

Step 1: Create Profile Directory

mkdir -p ~/.config/arc/profiles

Step 2: Create Profile YAML

Create a file like `~/.config/arc/profiles/custom.yaml`:

# Unique identifier (lowercase, no spaces)
id: custom

# Display name
name: My Custom Profile

# Brief description
description: Personalized tier names for my team

# Tier names (MUST have exactly 3 entries)
tier_names:
  - Bronze
  - Silver
  - Gold

# Theme ID (must reference existing theme)
# Valid: fire, nord, gruvbox, ocean, rainbow, solarized, monokai, cyan-purple, dracula
theme_id: fire

# ASCII logo (must spell "A.R.C.")
logo: |
   █████╗ ██████╗  ██████╗
  ██╔══██╗██╔══██╗██╔════╝
  ███████║██████╔╝██║
  ██╔══██║██╔══██╗██║
  ██║  ██║██║  ██║╚██████╗
  ╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝

  Custom Edition

# Optional: Custom colors (hex format)
primary_color: "#FF6B6B"
secondary_color: "#4ECDC4"

Step 3: Use Your Profile

arc config set-profile custom

User-defined profiles override embedded profiles with the same ID.

Profile Schema

Required Fields

  • `id` - Unique identifier (lowercase, no spaces)
  • `name` - Display name (user-facing)
  • `description` - Brief description of the profile theme
  • `tier_names` - Array with exactly 3 tier names (Tier 1, Tier 2, Tier 3)
  • `theme_id` - Must reference existing embedded theme
  • `logo` - ASCII art (must spell "A.R.C.")

Optional Fields

  • `primary_color` - Hex color (e.g., "#4A90E2")
  • `secondary_color` - Hex color (e.g., "#7B68EE")

Logo Guidelines

Content Rule: Logo text must spell "A.R.C." for branding consistency.

Creative Freedom:

  • Font selection from patorjk.com
  • Borders and frames
  • Icons and symbols
  • Background patterns
  • Decorative elements
  • Taglines or flavor text

Constraints:

  • Max width: 80 characters
  • Recommended height: 5-10 lines

Valid Examples:

  • ✅ "A.R.C." in Big font
  • ✅ "A.R.C." in Big font with lightning bolts
  • ✅ "A.R.C." with border + icons + tagline

Invalid Examples:

  • ❌ Triforce symbol only (no "A.R.C." text)
  • ❌ "JEDI" spelled out (not "A.R.C.")

Available Themes

Valid `theme_id` values:

Theme Colors Style
`cyan-purple` Blues and purples Professional
`fire` Oranges and reds Bold, energetic
`gruvbox` Browns and oranges Earthy, warm
`ocean` Blues and teals Cool, calm
`rainbow` Multi-color Vibrant, playful
`solarized` Warm/cool balanced Classic, refined
`monokai` Purples and pinks Rich, dark
`nord` Blues and grays Cool, minimal
`dracula` Dark purples/reds Dark, mystical

See Theme Guide for more details.

Troubleshooting

Profile doesn't change

  1. Check state file: `cat ~/.arc/state.json`
  2. Verify profile ID: `arc config list-profiles`
  3. Ensure profile file exists: `ls ~/.config/arc/profiles/`

Custom profile not loading

  1. Check file location: `~/.config/arc/profiles/yourprofile.yaml`
  2. Validate YAML syntax (use `yamllint` or online validator)
  3. Verify required fields are present
  4. Check tier_names has exactly 3 entries
  5. Ensure theme_id references a valid theme

Tier names not showing

  1. Verify profile is set: `arc config get-profile`
  2. Check tier_names in profile file
  3. Ensure workspace commands use the profile system

Integration with Workspace Commands

Profiles affect tier naming in workspace operations:

# Initialize workspace with jedi profile active
arc config set-profile jedi
arc workspace init

# Workspace tier will show as "Padawan", "Knight", or "Master"
arc workspace info