dlog

Log decisions in seconds. Search them later. Never forget why you chose X over Y.

dlog captures your team's decisions at the moment they happen — before the context fades. Each decision is automatically enriched by an LLM with structured outcome, reasoning, alternatives considered, and tags.

Install

npm install -g @tonytangdev/dlog

Get Started

# 1. Log in (you'll receive a magic link by email)
dlog login

# 2. Create a team
dlog team create

# 3. Log your first decision
dlog log "We chose PostgreSQL over MongoDB — better JSON support and team expertise"

That's it. Your decision is saved and will be enriched automatically within seconds.

Log Decisions

Capture a decision the moment you make it:

dlog log "Chose Tailwind over CSS-in-JS for styling"

Tag it with a project:

dlog log -p api "Switched from REST to tRPC for type safety"

Search & Recall

Find past decisions with natural language:

dlog search "database migration"

View the full enriched detail (outcome, reasoning, alternatives, tags):

dlog view 1       # use the index from search results

Browse recent decisions:

dlog list
dlog list --project api
dlog list --author "Tony"

Teams

dlog organizes decisions by team. Switch between teams or override per command:

dlog use my-team                                  # switch active team
dlog --team other-team log "Decision on other"    # one-off override
dlog team list                                    # see all your teams

All Commands

| Command | Description | |---------|-------------| | dlog login | Log in with magic link | | dlog logout | Log out | | dlog team create | Create a new team | | dlog team join <code> | Join with invite code | | dlog team list | List your teams | | dlog use [slug] | Switch active team | | dlog log [text] | Log a decision | | dlog search <query> | Search decisions | | dlog list | List recent decisions | | dlog view <id> | View decision details | | dlog edit <id> | Edit a decision | | dlog dismiss [ids...] | Dismiss review flags |

AI Agent Integration

dlog ships with a Claude Code skill that lets AI agents proactively log and search decisions on your behalf.

npx skills add tonytangdev/dlog-skill

Configuration

Config is stored at ~/.dlog/config.json.

| Variable | Description | Default | |----------|-------------|---------| | DLOG_API_URL | API endpoint | https://log-decisions-simplified.fly.dev | | DLOG_CONFIG_DIR | Config directory | ~/.dlog |

License

MIT