Metadata-Version: 2.4
Name: devtrail
Version: 0.1.0
Summary: Keep your project's context and state in one place across AI chat and code sessions.
License: MIT
Keywords: ai,context,state,developer-tools,claude,workflow
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# devtrail

![CI](https://github.com/abdelrahman-essam-d/devtrail/actions/workflows/ci.yml/badge.svg)

Keep your project's context and state in one place — across AI chat and code sessions.

Ever lose track of where you are in your project? Does an error send you back to
square one? Do you re-explain the whole context to every AI session? `devtrail`
keeps your project's thread in one file that any AI can read.

It's not another "dump my code into markdown" tool. It's a **decision memory**:
it remembers *what* you decided, *why*, what's still broken, and where you left off —
across any AI you use, in both English and Arabic.

## Install
```bash
pip install devtrail
```

## Usage
```bash
devtrail init                            # start a project
devtrail log "done built the schema"     # auto-filed under "Done"
devtrail log "error the DAG is failing"  # auto-filed under "Open issues"
devtrail log "decision chose ClickHouse" # auto-filed under "Decisions"
devtrail context                         # print the full state — paste into any AI
```

## Keywords (English + Arabic)
- issues: error, bug, issue, مشكلة, خطأ
- done: done, finished, complete, تم, خلصت
- decisions: decision, decide, قرار, قررت
- deferred: todo, later, defer, مؤجل, بعدين

A line with no keyword goes under "Current status".

## License
MIT
