kraven 0.3.0

Manage named environment variable profiles
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159

# kraven

Manage named environment variable profiles.

## Installation

```bash
cargo install kraven
```

## Usage

```bash
# List available profiles
kraven list

# Create or edit a profile
kraven edit my-profile

# Activate a profile (spawns a subshell with env vars)
kraven activate my-profile

# Show the currently active profile
kraven current

# Display profile contents
kraven show my-profile

# Display profile contents with masked values
kraven show my-profile --mask

# Show how to exit the current kraven session
kraven deactivate

# Remove a profile
kraven remove my-profile

# Encrypt a profile with GPG
kraven encrypt my-profile

# Decrypt an encrypted profile
kraven decrypt my-profile

# Show shell completion setup instructions
kraven completions
```

## Shell Completions

Enable tab completion by adding the appropriate line to your shell config:

```bash
# Bash (~/.bashrc)
source <(COMPLETE=bash kraven)

# Zsh (~/.zshrc)
source <(COMPLETE=zsh kraven)

# Fish (~/.config/fish/config.fish)
COMPLETE=fish kraven | source
```

Then restart your shell or source the config file.

## Customizing Your Shell Prompt

When a profile is active, Kraven sets the `KRAVEN_ACTIVE` environment variable to the profile name. You can use this to display the active profile in your shell prompt.

### Zsh

Add this to your `~/.zshrc`:

```zsh
precmd() {
    if [[ -n "$KRAVEN_ACTIVE" ]]; then
        kraven_info="[${KRAVEN_ACTIVE}] "
    else
        kraven_info=""
    fi
}

setopt PROMPT_SUBST
PROMPT='${kraven_info}%~ %# '
```

### Bash

Add this to your `~/.bashrc`:

```bash
set_prompt() {
    if [[ -n "$KRAVEN_ACTIVE" ]]; then
        kraven_info="[${KRAVEN_ACTIVE}] "
    else
        kraven_info=""
    fi
    PS1="${kraven_info}\w \$ "
}
PROMPT_COMMAND=set_prompt
```

### Fish

Add this to your `~/.config/fish/config.fish` or create `~/.config/fish/functions/fish_prompt.fish`:

```fish
function fish_prompt
    if set -q KRAVEN_ACTIVE
        echo -n "[$KRAVEN_ACTIVE] "
    end
    echo -n (prompt_pwd) '> '
end
```

## GPG Encryption

Profiles containing sensitive credentials can be encrypted with GPG. This requires GPG to be installed and a default key to be configured.

```bash
# Encrypt an existing profile (uses your default GPG key)
kraven encrypt my-profile

# Decrypt it back to plain text
kraven decrypt my-profile
```

Encrypted profiles are stored as `<name>.gpg` files alongside plain profiles. All commands (`activate`, `show`, `edit`, `remove`, `list`) work transparently with encrypted profiles — decryption happens automatically when needed. You can refer to a profile by either its base name or with the `.gpg` suffix:

```bash
# These are equivalent
kraven show my-profile
kraven show my-profile.gpg
```

For editing encrypted profiles, your editor must handle GPG natively (e.g., Vim with the `gnupg.vim` plugin).

`kraven list` shows an `(encrypted)` indicator next to encrypted profiles.

## Profile Format

Profiles are stored as plain text files in `~/.config/kraven/` using the standard dotenv format:

```
KEY=value
ANOTHER_KEY=another_value

# Comments start with #
QUOTED="value with spaces"
SINGLE_QUOTED='literal $value without expansion'

# Double-quoted values support escape sequences
ESCAPED="line1\nline2\ttabbed"
```

Supported escape sequences in double-quoted values: `\"`, `\\`, `\n`, `\t`

## License

GPL-3.0