PkgFoundry
Catalog PyPI
Back to packageRELEASE DETAILS

0.1.0

PyPI

agentflow-cli

Git-like workflow management for AI agents

agentaicligitsession-trackingversion-controlworkflow
Published16 Jan 2026
Direct dependencies14
Transitive dependenciesNot calculated

README

Version 0.1.0 documentation

AgentFlow

Git-like workflow management for AI agents.

Overview

AgentFlow is a workflow management system designed to help AI agents track and manage their work sessions in a structured, version-controlled manner similar to how Git manages code.

Features

  • Workspace Management - Organize work into isolated workspaces for different projects
  • Session Tracking - Track work sessions with start/end times and status
  • Action Logging - Log detailed actions during active sessions
  • Commit System - Create commits to summarize completed work with parent-child relationships
  • Multiple Databases - Support for PostgreSQL and SQLite

Installation

pip install agentflow-cli

Or using uv:

uv pip install agentflow-cli

Quick Start

1. Initialize

Interactive setup:

agentflow init

Or with a direct database URL:

agentflow init --db-url "postgresql://user:pass@localhost/agentflow"

For SQLite:

agentflow init --db-url "sqlite:///agentflow.db"

2. Create a Workspace

agentflow workspace create my-project
agentflow workspace switch my-project

3. Start a Session

agentflow session start "Implement user authentication"

4. Log Actions

agentflow session log "Created User model"
agentflow session log "Added login endpoint"

5. Check Status

agentflow session status

Commands

Configuration

  • agentflow init - Initialize configuration
  • agentflow config show - Show current configuration
  • agentflow config test - Test database connection

Workspace

  • agentflow workspace create <name> - Create a new workspace
  • agentflow workspace list - List all workspaces
  • agentflow workspace switch <name> - Switch to a workspace
  • agentflow workspace current - Show current workspace

Session

  • agentflow session start <task> - Start a new session
  • agentflow session status - Show current session status
  • agentflow session abort - Abort the current session
  • agentflow session log <action> - Log an action to the current session

Requirements

  • Python >= 3.14
  • PostgreSQL or SQLite

Development

Install development dependencies:

uv pip install -e ".[dev]"

Run tests:

uv run pytest

Lint:

uv run ruff check

Type check:

uv run mypy

License

MIT

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 14

Native requirements
14 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
typer
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.14",
  "evaluation": "NOT_EVALUATED"
}
typer>=0.12.0runtime
sqlalchemy
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.14",
  "evaluation": "NOT_EVALUATED"
}
sqlalchemy>=2.0.0runtime
asyncpg
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.14",
  "evaluation": "NOT_EVALUATED"
}
asyncpg>=0.29.0runtime
alembic
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.14",
  "evaluation": "NOT_EVALUATED"
}
alembic>=1.13.0runtime
pydantic
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.14",
  "evaluation": "NOT_EVALUATED"
}
pydantic>=2.0.0runtime
pydantic-settings
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.14",
  "evaluation": "NOT_EVALUATED"
}
pydantic-settings>=2.0.0runtime
rich
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.14",
  "evaluation": "NOT_EVALUATED"
}
rich>=13.0.0runtime
python-dateutil
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.14",
  "evaluation": "NOT_EVALUATED"
}
python-dateutil>=2.8.0runtime
questionary
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.14",
  "evaluation": "NOT_EVALUATED"
}
questionary>=2.1.1runtime
pytest
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.14",
  "evaluation": "NOT_EVALUATED"
}
pytest>=8.0.0; extra == "dev"runtime
pytest-asyncio
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.14",
  "evaluation": "NOT_EVALUATED"
}
pytest-asyncio>=0.23.0; extra == "dev"runtime
aiosqlite
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.14",
  "evaluation": "NOT_EVALUATED"
}
aiosqlite>=0.19.0; extra == "dev"runtime
mypy
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.14",
  "evaluation": "NOT_EVALUATED"
}
mypy>=1.0.0; extra == "dev"runtime
ruff
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.14",
  "evaluation": "NOT_EVALUATED"
}
ruff>=0.1.0; extra == "dev"runtime

Distribution files

2 collected
agentflow_cli-0.1.0-py3-none-any.whl

bdist_wheel · 22.38 KB · Python py3

Source file
agentflow_cli-0.1.0.tar.gz

sdist · 21.62 KB · Python source

Source file

Repository

PENDING
developers-secrets-inc/agentflow

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 21:55 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:f0544bd170b0bc2d71f69d1ad67c0108dcbaed726c65422777757bb5502d7bae

Other collected versions

View all collected versions →