init

The init command sets up kasl configuration interactively, guiding you through the initial setup process.

Usage

kasl init [OPTIONS]

Options

Option	Description
`-d, --delete`	Remove existing configuration instead of creating new one
`-h, --help`	Print help information

Description

The init command provides an interactive configuration wizard that guides you through setting up:

Monitor Settings: Activity detection thresholds and timing
API Integrations: GitLab, Jira, and SiServer connections
Server Configuration: External reporting endpoints
Credential Management: Secure storage setup

Interactive Setup

Monitor Configuration

Configure activity monitoring behavior:

Minimum pause duration (minutes) [20]:
Pause threshold (seconds) [60]:
Poll interval (milliseconds) [500]:
Activity threshold (seconds) [30]:
Minimum work interval (minutes) [10]:

Settings Explained:

Minimum pause duration: Breaks shorter than this are ignored
Pause threshold: Time without activity before pause detection
Poll interval: How often to check for activity
Activity threshold: Continuous activity needed to start workday
Minimum work interval: Short intervals to merge

API Integrations

Configure external service connections:

GitLab Integration

Enable GitLab integration? (y/N): y
GitLab API URL [https://gitlab.com]:
GitLab Access Token:

Jira Integration

Enable Jira integration? (y/N): y
Jira API URL:
Jira Username:

SiServer Integration

Enable SiServer integration? (y/N): y
SiServer Auth URL:
SiServer API URL:
SiServer Username:

Server Configuration

Configure external reporting:

Enable external reporting? (y/N): y
Server API URL:
Authentication Token:

Configuration Reset

Remove existing configuration:

kasl init --delete

This will:

Delete the configuration file
Remove global PATH settings
Reset to initial state

Configuration File Location

Configuration is stored in platform-specific locations:

Windows: %LOCALAPPDATA%\lacodda\kasl\config.json
macOS: ~/Library/Application Support/lacodda/kasl/config.json
Linux: ~/.local/share/lacodda/kasl/config.json

Example Configuration

After running init, your configuration will look like:

{
  "monitor": {
    "min_pause_duration": 20,
    "pause_threshold": 60,
    "poll_interval": 500,
    "activity_threshold": 30,
    "min_work_interval": 10
  },
  "gitlab": {
    "access_token": "glpat-XXXXXXXXXXXXXXXXXXXX",
    "api_url": "https://gitlab.com"
  },
  "jira": {
    "login": "john.doe",
    "api_url": "https://company.atlassian.net"
  },
  "si": {
    "login": "john.doe@company.com",
    "auth_url": "https://auth.company.com",
    "api_url": "https://api.company.com"
  },
  "server": {
    "api_url": "https://api.company.com/timetracking",
    "auth_token": "your-api-token"
  }
}

Credential Management

Secure Storage

Credentials are stored securely:

API Tokens: Encrypted in separate files
Passwords: Prompted interactively, not stored
Session Data: Cached temporarily

File Permissions

Ensure proper file permissions:

# Linux/macOS
chmod 600 ~/.local/share/lacodda/kasl/config.json
chmod 700 ~/.local/share/lacodda/kasl/

Troubleshooting

Configuration Issues

Problem: Configuration not saved

# Check file permissions
ls -la ~/.local/share/lacodda/kasl/config.json

# Recreate configuration
kasl init --delete
kasl init

Problem: Invalid configuration

# Validate JSON syntax
python -m json.tool ~/.local/share/lacodda/kasl/config.json

# Reset configuration
kasl init --delete
kasl init

API Configuration Issues

Problem: API connection failures

# Test connectivity
curl -H "Authorization: Bearer YOUR_TOKEN" https://gitlab.com/api/v4/user

# Reconfigure integration
kasl init

Examples

Basic Setup

# Run interactive setup
kasl init

# Follow prompts to configure:
# 1. Monitor settings
# 2. API integrations (optional)
# 3. Server configuration (optional)

Reset Configuration

# Remove existing configuration
kasl init --delete

# Run setup again
kasl init

Partial Configuration

# Run setup and skip optional integrations
kasl init

# Only configure monitor settings
# Skip GitLab, Jira, and SiServer when prompted

Next Steps

After running init:

Start monitoring:
Terminal window
```
kasl watch
```
Enable autostart (optional):
Terminal window
```
kasl autostart enable
```

Create your first task:

kasl task add --name "Set up kasl" --completeness 100

View your report:
Terminal window
```
kasl report
```

watch - Start activity monitoring
task - Manage tasks
report - Generate reports
autostart - Configure automatic startup