zam 0.6.0

Enhanced shell history manager with sensitive data redaction
Documentation 
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

# zam(1) - shell history manager

[![CI](https://github.com/fmeyer/zam/actions/workflows/ci.yml/badge.svg)](https://github.com/fmeyer/zam/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## SYNOPSIS

    zam <command> [options]

## DESCRIPTION

**zam** is a shell history manager with automatic sensitive data redaction,
alias management, SQLite storage, and multi-host session tracking.

## INSTALL

    cargo install --path .

Or from crates.io:

    cargo install zam

## COMMANDS

    log <command>       Log a command to history
    search <term>       Search command history
    recent              Show recent commands
    frequent            Show most-used commands
    import <shell>      Import history from zsh, bash, or fish
    export              Export history (json, csv, tsv, plain)
    stats               Display usage statistics
    status              Show backend and configuration
    clear               Clear history (with confirmation)
    config              Manage configuration
    validate            Test redaction patterns
    shell <type>        Generate shell integration script
    fzf                 Output commands for fzf integration
    tui                 Interactive entity browser (TUI)
    merge <db-file>     Merge another database
    tokens              Manage stored redacted tokens
    hosts               List tracked hosts
    sessions            List shell sessions
    alias               Manage shell aliases

## OPTIONS

    -c, --config <path>     Configuration file path
    -v, --verbose           Verbose output
    -q, --quiet             Suppress non-error output
        --no-color          Disable colored output
        --use-file          Force file-based backend

## USAGE

    # Log and search
    zam log "git push origin main"
    zam search "git"
    zam search --regex "git (commit|push)"
    zam search --fuzzy "dckr"
    zam recent --count 10

    # Interactive TUI browser
    zam tui

    # Shell integration (add to shell rc file)
    eval "$(zam shell zsh)"

    # Alias management
    zam alias add ll "ls -la" "long listing"
    zam alias list
    zam alias export

    # Import existing history
    zam import zsh
    zam import bash

    # Merge from another machine
    zam merge ~/backup/history.db

    # Check status
    zam status

## CONFIGURATION

Default config file: `~/.zam.json`

    zam config --init       Generate default config
    zam config --show       Print current config

Key settings: redaction patterns, search defaults, shell integration
exclusions, import paths.

## REDACTION

Automatically detects and redacts passwords, API keys, tokens, connection
strings, bearer tokens, SSH keys, AWS credentials, and GitHub tokens.

Custom patterns can be added via configuration.

    zam validate "pattern" --test "test string"

## STORAGE

Default location: `~/.local/zam/`

- Database backend (default): `zam.db` -- SQLite with sessions, hosts, tokens
- File backend (`--use-file`): `zam.log` -- structured log format

## BUILDING

    git clone https://github.com/fmeyer/zam.git
    cd zam
    cargo build --release
    cargo test

## LICENSE

MIT