logics-manager
Your project's memory, in Markdown, in your repo. logics-manager turns requests, backlog items, tasks and decisions into plain Markdown documents that live next to your code, so every human and every AI assistant picks up the same context instead of starting over.
AI-heavy projects lose context between chats, agents and implementation passes. Logics keeps it as durable, versioned artifacts: one delivery chain, framed by the documents around it.
Get started in a minute
Install with npm (works the same on macOS, Linux and Windows / WSL):
npm install -g @grifhinz/logics-manager
logics-manager bootstrap --check
logics-manager flow new request --title "Improve onboarding"
logics-manager view
bootstrap sets up the logics/ tree, flow new writes your first request, and view
opens the board in your browser. Installing from source, Python packages and Obsidian
usage are covered in getting started.
What you can do
| Need | Command | Detail |
|---|---|---|
| Capture and scope work | flow new, flow promote, flow split |
Core CLI |
| Plan across versions | flow roadmap propose |
Core CLI |
| See the board, read and filter docs | view, or the VS Code extension |
The viewer, VS Code |
| Keep the corpus consistent | lint, audit, health, flow close |
Core CLI |
| Feed an assistant bounded context | sync context-pack, MCP server |
MCP for assistants |
| Teach your agents the workflow | skills install |
Bundled skills |
One CLI owns the behavior; the VS Code extension and the MCP server call into it instead of reimplementing workflow logic. The MCP server gives assistants a bounded tool API with no shell or arbitrary filesystem access. Your documents stay plain Markdown, versioned with git and readable in reviews. See concepts and product shape.
Documentation
- Getting started: install paths, first steps, Obsidian usage.
- Concepts and product shape: document types, the CLI and its clients.
- The viewer: board, reader, insights, list mode.
- Core CLI: commands, agent cookbook, contracts, closing work.
- VS Code extension: features, installation, command palette.
- MCP for assistants: tool surface, connector plans, assistant model.
- Onboarding prompts: starting prompts for need, framing, orchestration, execution.
- Project i18n contract and GitHub Issues bridge: optional integrations.
- Development and validation and release: for contributors.
Full index in docs/. Security reports: see SECURITY.md;
contributions: CONTRIBUTING.md. logics-manager is MIT licensed.
Record work performed by any runner against a request, backlog item or task:
logics-manager flow record-run task_001_example --runner ci --run-id build-42 --state succeeded --pr https://github.com/example/project/pull/42 --progress auto
The # Executions table tracks attempts by runner and run id. Repeating that pair
updates its row and timestamp. Task progress can be calculated from successful or
merged executions. See the flow reference.
1 maintainer
Metadata
1 maintainer
Release files for logics-manager 2.24.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| logics_manager-2.24.3.tar.gz | 4.2 MB | Without provenance | Details for logics_manager-2.24.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| logics_manager-2.24.3-py3-none-any.whl | Python 3 | none | any | Details for logics_manager-2.24.3-py3-none-any.whl |
Total release size: 8.4 MB
Release files / logics_manager-2.24.3.tar.gz
| Download URL | logics_manager-2.24.3.tar.gz |
|---|---|
| Size | 4.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
80d274ce4f0bc5a69eb8ea338b2fb3b9008f4a1811768f0ce64a4da6cd8ed7ca
|
|
BLAKE2b-256 checksum How to use checksums |
edf424c1b14499780c35edd3668a1edea9005092d7eb5033197905c7c740f0fa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Release files / logics_manager-2.24.3-py3-none-any.whl
| Download URL | logics_manager-2.24.3-py3-none-any.whl |
|---|---|
| Size | 4.2 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
69b0f429caeaee9b81646bdb4b3a421d6099274f6a729f03945a9f58ea8c925d
|
|
BLAKE2b-256 checksum How to use checksums |
38346e506fef95c643ce05d9dabb89f4f255cae2ff3b91a8a01252a83025b1b3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Security for logics-manager 2.24.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
