Skip to main content

viben user

User identity management supporting multi-developer/multi-agent collaboration.

Overview​

The viben user command is used to manage user identity and is the foundation of the Viben workflow. Each developer (human or agent) needs to initialize their identity to use task management and session recording features.

Command Structure​

viben user <subcommand> [options]

Subcommand Overview​

SubcommandDescription
initInitialize user identity
getGet current user identity

Initialize Identity​

viben user init <name>

Naming Suggestions:

TypeExamples
Human developerjohn, alice, zhang-san
Claude Code agentclaude-agent, claude-task-001
Cursor agentcursor-agent
Gemini agentgemini-agent

Creates File: .viben/.developer (gitignored)

Creates Directory: .viben/workspace/<name>/

Examples:

viben user init john
viben user init claude-agent

Output:

[INFO] Creating developer workspace...
[SUCCESS] Developer initialized: john
[INFO] Created: .viben/.developer
[INFO] Created: .viben/workspace/john/index.md
[INFO] Created: .viben/workspace/john/journal-1.md

Note: If already initialized, shows current user and exits:

Developer already initialized: john

To reinitialize, remove .viben/.developer first

Get Identity​

viben user get           # Output username
viben user get --json    # JSON format output

Options:

OptionDescription
--jsonJSON format output

Examples:

viben user get
# Output: john

viben user get --json
# Output: {"user": "john"}

When Not Initialized:

Developer not initialized

Storage Structure​

.viben/
├── .developer                    # User identity file (gitignored)
│                                 # Content: name=john
└── workspace/
    ├── index.md                  # Main index (active developers table)
    └── john/                     # User workspace
        ├── index.md              # Personal index
        └── journal-1.md          # Session journal

.developer File Format​

name=john

workspace/index.md Format​

# Viben Workspace Index

## Active Developers

| Name | Last Active | Sessions |
|------|-------------|----------|
| john | 2024-03-03  | 15       |

workspace/{user}/index.md Format​

# Workspace - john

## Status

<!-- @@@auto:current-status -->
- **Active File**: `journal-1.md`
- **Total Sessions**: 15
- **Last Active**: 2024-03-03
<!-- @@@/auto:current-status -->

## Documents

<!-- @@@auto:active-documents -->
| File | Lines | Status |
|------|-------|--------|
| `journal-1.md` | ~1500 | Active |
<!-- @@@/auto:active-documents -->

## Session History

<!-- @@@auto:session-history -->
| # | Date | Task | Commits |
|---|------|------|---------|
| 15 | 2024-03-03 | Add user auth | `abc1234` |
| 14 | 2024-03-02 | Fix bug | `def5678` |
<!-- @@@/auto:session-history -->