MCPcopy Index your code
hub / github.com/ActivityWatch/aw-core

github.com/ActivityWatch/aw-core @v0.5.17

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.5.17 ↗ · + Follow
358 symbols 1,519 edges 47 files 70 documented · 20%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

aw-core

GitHub Actions badge Code coverage PyPI Code style: black Typechecking: Mypy

Core library for ActivityWatch.

Modules

  • aw_core, contains basic datatypes and utilities, such as the Event class, helpers for configuration and logging, as well as schemas for buckets, events, and exports.
  • aw_datastore, contains the datastore classes used by aw-server-python.
  • aw_transform, all event-transforms used in queries.
  • aw_query, the query-language used by ActivityWatch.

Logging

Run python with LOG_LEVEL=debug to use change the log level across all AW components

How to install

To install the latest git version directly from github without cloning, run pip install git+https://github.com/ActivityWatch/aw-core.git

To install from a cloned version, cd into the directory and run poetry install to install inside an virtualenv. If you want to install it system-wide it can be installed with pip install ., but that has the issue that it might not get the exact version of the dependencies due to not reading the poetry.lock file.

Core symbols most depended-on inside this repo

get
called by 49
aw_datastore/datastore.py
insert
called by 38
aw_datastore/datastore.py
query
called by 23
aw_query/query2.py
parse
called by 20
aw_query/query2.py
_parse_token
called by 20
aw_query/query2.py
delete_bucket
called by 14
aw_datastore/datastore.py
create_bucket
called by 13
aw_datastore/datastore.py
replace
called by 11
aw_datastore/datastore.py

Shape

Function 198
Method 133
Class 27

Languages

Python100%

Modules by API surface

aw_query/query2.py40 symbols
tests/test_datastore.py29 symbols
aw_datastore/storages/peewee.py29 symbols
aw_query/functions.py28 symbols
tests/test_transforms.py18 symbols
aw_datastore/storages/sqlite.py18 symbols
aw_datastore/datastore.py18 symbols
tests/test_query2.py16 symbols
aw_datastore/storages/memory.py15 symbols
aw_datastore/storages/abstract.py15 symbols
aw_core/models.py12 symbols
tests/test_schemas.py10 symbols

For agents

$ claude mcp add aw-core \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact