logflow-cli 0.1.7

Focused developer journaling and ideation loop

Logflow

📘 Quickstart Guide – Learn how to install and use Logflow in minutes.

💡 Tip: For the best experience, install with extras:

pipx install logflow-cli[rich,fancy_slugs]

This enables rich terminal output and emoji-safe filenames.

---

🧠 How Logflow Stores Data

By default, Logflow stores all your developer thoughts in:

./logflow/

This directory includes:

• daily_logs/ – developer check-ins
• ideas/ – structured Markdown idea files
• idea_log.md – append-only quick thought list
• completed_log.md – a snapshot of done ideas
• next_id.txt – internal idea counter
• config.toml – optional config file

Example Config:

[paths]
log_dir = "logflow"
scan_root = "parent"
max_recent_ideas = 5

Run logflow init to generate this layout and config.

---

Or forcibly regenerate:

logflow init --force

---

💡 Use Cases

• Solo dev journaling
• Idea tracking across projects
• Developer time tracking & status reporting
• Task queue for future sprints

---

📘 Command Cheat Sheet

logflow add "Idea"               # Quick log
logflow add "X" --title T --body B --tag TAG

logflow recent                   # Show recent ideas
logflow index                    # Structured idea index

logflow focus                    # Start dev work
logflow status                   # What am I working on?
logflow pause                    # Mark break/end of session

logflow complete 007             # Mark done
logflow delete slug_or_id        # Soft delete
logflow purge                    # Trash cleanup

logflow history --summary        # View logs
logflow init --force             # Regenerate config & folders
logflow help                     # Command list

---

🎯 Philosophy

Logflow is designed to:

• Work with or without Git
• Require zero setup, but allow full config
• Help developers reflect, prioritize, and focus

It's built for long-term sustainability of developer thought.

---

🔓 License

MIT

---

📣 Maintained by Oravox LLC — freely available for solo devs, teams, and contributors.