Metadata-Version: 2.4
Name: agent-log
Version: 4.3b0
Summary: A command-line journal built for AI agents, with semantic search.
License-Expression: GPL-3.0-only
License-File: LICENSE.md
Author: Micah Ellison
Author-email: micahellison@gmail.com
Maintainer: Jonathan Wren and Micah Ellison
Maintainer-email: maintainers@jrnl.sh
Requires-Python: >=3.10.0,<3.15
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Office/Business :: News/Diary
Provides-Extra: semantic
Requires-Dist: colorama (>=0.4)
Requires-Dist: cryptography (>=3.0)
Requires-Dist: fastembed (>=0.3) ; extra == "semantic"
Requires-Dist: keyring (>=21.0)
Requires-Dist: numpy (>=1.24) ; extra == "semantic"
Requires-Dist: parsedatetime (>=2.6)
Requires-Dist: python-dateutil (>=2.8,<3.0)
Requires-Dist: pyxdg (>=0.27.0)
Requires-Dist: rich (>=14.3.2,<14.4.0)
Requires-Dist: ruamel.yaml (>=0.17.22)
Requires-Dist: ruamel.yaml.clib (>=0.2.12)
Requires-Dist: tzlocal (>=4.0)
Project-URL: Issue Tracker, https://github.com/keithagroves/a-log/issues
Project-URL: Repository, https://github.com/keithagroves/a-log
Description-Content-Type: text/markdown

<!--
Copyright © 2012-2023 alog contributors
Copyright © 2025 a-log contributors
License: https://www.gnu.org/licenses/gpl-3.0.html
-->

<p align="center">
  <img src="a-log.png" alt="a-log" width="600" />
</p>

# a-log

**a-log** (agent log) is a command-line journal built for AI agents. It is a fork of [jrnl](https://github.com/jrnl-org/jrnl), extended with semantic search and designed to give agents a persistent, searchable memory.

## Features

- **Semantic search** — find entries by meaning, not just keywords
- Plain-text, human-readable journal files
- Timestamp-aware entry parsing
- AES encryption support
- External editor integration

## Quick Start

Create a new entry:

```sh
alog yesterday: Refactored the authentication module. Moved token validation into middleware.
```

Search by meaning:

```sh
alog --semantic "auth changes"
```

Everything before the first sentence-ending punctuation (`.`, `?`, `!`) is the title; the rest is the body. In your journal file, the result looks like:

    [2025-06-15 09:00] Refactored the authentication module.
    Moved token validation into middleware.

If you just call `alog` with no arguments, you will be prompted to compose your entry.

## Origin

a-log is a fork of [jrnl](https://jrnl.sh) by Jonathan Wren, Micah Ellison, and [many contributors](https://github.com/jrnl-org/jrnl/graphs/contributors). It retains full compatibility with jrnl's journal format while adding agent-oriented capabilities like semantic indexing and search.

