taskflow-agent 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,12 @@
1
+ venv/
2
+ __pycache__/
3
+ *.pyc
4
+ *.db
5
+ .claude/
6
+ .excel_mcp_server.pid
7
+ exports/
8
+ logs/
9
+ .env
10
+ data/taskflow-web.pid
11
+ data/agent_memory.md
12
+ data/repos.json
@@ -0,0 +1,131 @@
1
+ # PolyForm Noncommercial License 1.0.0
2
+
3
+ <https://polyformproject.org/licenses/noncommercial/1.0.0>
4
+
5
+ ## Acceptance
6
+
7
+ In order to get any license under these terms, you must agree
8
+ to them as both strict obligations and conditions to all
9
+ your licenses.
10
+
11
+ ## Copyright License
12
+
13
+ The licensor grants you a copyright license for the
14
+ software to do everything you might do with the software
15
+ that would otherwise infringe the licensor's copyright
16
+ in it for any permitted purpose. However, you may
17
+ only distribute the software according to [Distribution
18
+ License](#distribution-license) and make changes or new works
19
+ based on the software according to [Changes and New Works
20
+ License](#changes-and-new-works-license).
21
+
22
+ ## Distribution License
23
+
24
+ The licensor grants you an additional copyright license
25
+ to distribute copies of the software. Your license
26
+ to distribute covers distributing the software with
27
+ changes and new works permitted by [Changes and New Works
28
+ License](#changes-and-new-works-license).
29
+
30
+ ## Notices
31
+
32
+ You must ensure that anyone who gets a copy of any part of
33
+ the software from you also gets a copy of these terms or the
34
+ URL for them above, as well as copies of any plain-text lines
35
+ beginning with `Required Notice:` that the licensor provided
36
+ with the software. For example:
37
+
38
+ > Required Notice: Copyright Henry Chien (https://github.com/henrysouchien/taskflow-agent)
39
+
40
+ ## Changes and New Works License
41
+
42
+ The licensor grants you an additional copyright license to
43
+ make changes and new works based on the software for any
44
+ permitted purpose.
45
+
46
+ ## Patent License
47
+
48
+ The licensor grants you a patent license for the software that
49
+ covers patent claims the licensor can license, or becomes able
50
+ to license, that you would infringe by using the software.
51
+
52
+ ## Noncommercial Purposes
53
+
54
+ Any noncommercial purpose is a permitted purpose.
55
+
56
+ ## Personal Uses
57
+
58
+ Personal use for research, experiment, and testing for
59
+ the benefit of public knowledge, personal study, private
60
+ entertainment, hobby projects, amateur pursuits, or religious
61
+ observance, without any anticipated commercial application,
62
+ is use for a permitted purpose.
63
+
64
+ ## Noncommercial Organizations
65
+
66
+ Use by any charitable organization, educational institution,
67
+ public research organization, public safety or health
68
+ organization, environmental protection organization,
69
+ or government institution is use for a permitted purpose
70
+ regardless of the source of funding or obligations resulting
71
+ from the funding.
72
+
73
+ ## Fair Use
74
+
75
+ You may have "fair use" rights for the software under the
76
+ law. These terms do not limit them.
77
+
78
+ ## No Other Rights
79
+
80
+ These terms do not allow you to sublicense or transfer any of
81
+ your licenses to anyone else, or prevent the licensor from
82
+ granting licenses to anyone else. These terms do not imply
83
+ any other licenses.
84
+
85
+ ## Patent Defense
86
+
87
+ If you make any written claim that the software infringes or
88
+ contributes to infringement of any patent, your patent license
89
+ for the software granted under these terms ends immediately. If
90
+ your company makes such a claim, your patent license ends
91
+ immediately for work on behalf of your company.
92
+
93
+ ## Violations
94
+
95
+ The first time you are notified in writing that you have
96
+ violated any of these terms, or done anything with the software
97
+ not covered by your licenses, your licenses can nonetheless
98
+ continue if you come into full compliance with these terms,
99
+ and take practical steps to correct past violations, within
100
+ 32 days of receiving notice. Otherwise, all your licenses
101
+ end immediately.
102
+
103
+ ## No Liability
104
+
105
+ ***As far as the law allows, the software comes as is, without
106
+ any warranty or condition, and the licensor will not be liable
107
+ to you for any damages arising out of these terms or the use
108
+ or nature of the software, under any kind of legal claim.***
109
+
110
+ ## Definitions
111
+
112
+ The **licensor** is the individual or entity offering these
113
+ terms, and the **software** is the software the licensor makes
114
+ available under these terms.
115
+
116
+ **You** refers to the individual or entity agreeing to these
117
+ terms.
118
+
119
+ **Your company** is any legal entity, sole proprietorship,
120
+ or other kind of organization that you work for, plus all
121
+ organizations that have control over, are under the control of,
122
+ or are under common control with that organization. **Control**
123
+ means ownership of substantially all the assets of an entity,
124
+ or the power to direct its management and policies by vote,
125
+ contract, or otherwise. Control can be direct or indirect.
126
+
127
+ **Your licenses** are all the licenses granted to you for the
128
+ software under these terms.
129
+
130
+ **Use** means anything you do with the software requiring one
131
+ of your licenses.
@@ -0,0 +1,46 @@
1
+ .PHONY: serve dev stop status
2
+
3
+ PYTHON := venv/bin/python
4
+
5
+ # Start server in foreground (Ctrl-C to stop)
6
+ serve:
7
+ $(PYTHON) -m src.web
8
+
9
+ # Start with auto-reload for development
10
+ dev:
11
+ $(PYTHON) -m uvicorn src.web:app --host 127.0.0.1 --port 8787 --reload
12
+
13
+ # Stop whatever is listening on port 8787 (works for both foreground and MCP-managed)
14
+ # Waits for exit before cleaning up PID file to avoid orphaning a managed process.
15
+ stop:
16
+ @PID=$$(lsof -nP -i :8787 -sTCP:LISTEN -t 2>/dev/null); \
17
+ if [ -n "$$PID" ]; then \
18
+ kill $$PID 2>/dev/null || true; \
19
+ echo "Sent SIGTERM to PID $$PID, waiting..."; \
20
+ for i in 1 2 3 4 5 6 7 8 9 10; do \
21
+ kill -0 $$PID 2>/dev/null || break; \
22
+ sleep 0.5; \
23
+ done; \
24
+ if kill -0 $$PID 2>/dev/null; then \
25
+ echo "Still alive, sending SIGKILL"; \
26
+ kill -9 $$PID 2>/dev/null || true; \
27
+ sleep 1; \
28
+ fi; \
29
+ if ! kill -0 $$PID 2>/dev/null; then \
30
+ rm -f data/taskflow-web.pid; \
31
+ echo "Stopped"; \
32
+ else \
33
+ echo "Failed to stop PID $$PID — PID file retained"; \
34
+ fi; \
35
+ else \
36
+ echo "Not running"; \
37
+ fi
38
+
39
+ # Check if server is listening
40
+ status:
41
+ @PID=$$(lsof -nP -i :8787 -sTCP:LISTEN -t 2>/dev/null); \
42
+ if [ -n "$$PID" ]; then \
43
+ echo "Running (PID $$PID)"; \
44
+ else \
45
+ echo "Not running"; \
46
+ fi
@@ -0,0 +1,136 @@
1
+ Metadata-Version: 2.4
2
+ Name: taskflow-agent
3
+ Version: 0.1.0
4
+ Summary: Lightweight project and task manager with MCP tools for Claude Code
5
+ Project-URL: Repository, https://github.com/henrysouchien/taskflow-agent
6
+ Author: Henry Chien
7
+ License-Expression: PolyForm-Noncommercial-1.0.0
8
+ License-File: LICENSE
9
+ Keywords: ai,claude,mcp,project-manager,task-manager
10
+ Classifier: Development Status :: 4 - Beta
11
+ Classifier: Intended Audience :: Developers
12
+ Classifier: License :: Other/Proprietary License
13
+ Classifier: Programming Language :: Python :: 3
14
+ Classifier: Programming Language :: Python :: 3.10
15
+ Classifier: Programming Language :: Python :: 3.11
16
+ Classifier: Programming Language :: Python :: 3.12
17
+ Classifier: Topic :: Office/Business :: Scheduling
18
+ Requires-Python: >=3.10
19
+ Requires-Dist: mcp>=1.0.0
20
+ Provides-Extra: web
21
+ Requires-Dist: fastapi; extra == 'web'
22
+ Requires-Dist: python-dotenv; extra == 'web'
23
+ Requires-Dist: uvicorn; extra == 'web'
24
+ Description-Content-Type: text/markdown
25
+
26
+ # taskflow-agent
27
+
28
+ Lightweight project and task manager with MCP tools for Claude Code.
29
+
30
+ SQLite backend, 20 MCP tools, web UI with embedded AI chat, and a FastAPI REST API. Built as a self-hosted Asana replacement optimized for AI-assisted workflows.
31
+
32
+ ## Features
33
+
34
+ - **20 MCP tools** — full project/task CRUD, search, views, service lifecycle management
35
+ - **Web UI** — dark-theme SPA with project boards, task details, inline editing
36
+ - **AI chat** — embedded Claude chat with workspace awareness and tool access
37
+ - **FTS search** — full-text search across task names and notes
38
+ - **Asana import** — bulk import from Asana CSV exports
39
+ - **Service management** — start/stop the web server via MCP tools or Makefile
40
+
41
+ ## Quick Start
42
+
43
+ ```bash
44
+ pip install -e ".[web]"
45
+
46
+ # Start the MCP server (for Claude Code)
47
+ taskflow
48
+
49
+ # Start the web UI
50
+ make serve # foreground
51
+ taskflow-web # via CLI
52
+ ```
53
+
54
+ ## MCP Tools
55
+
56
+ ### Projects
57
+ | Tool | Description |
58
+ |------|-------------|
59
+ | `tf_list_projects` | List active projects with task counts |
60
+ | `tf_get_project` | Get project with sections and tasks |
61
+ | `tf_create_project` | Create a new project |
62
+ | `tf_update_project` | Update project fields |
63
+ | `tf_archive_project` | Archive a project |
64
+
65
+ ### Sections
66
+ | Tool | Description |
67
+ |------|-------------|
68
+ | `tf_create_section` | Add a section to a project |
69
+ | `tf_update_section` | Update section fields |
70
+ | `tf_move_section` | Reorder a section |
71
+
72
+ ### Tasks
73
+ | Tool | Description |
74
+ |------|-------------|
75
+ | `tf_list_tasks` | List tasks with filters |
76
+ | `tf_get_task` | Get task details with subtasks and tags |
77
+ | `tf_create_task` | Create a task |
78
+ | `tf_update_task` | Update task fields |
79
+ | `tf_complete_task` | Mark task completed |
80
+ | `tf_reopen_task` | Reopen a completed task |
81
+ | `tf_move_task` | Move task between projects/sections |
82
+ | `tf_delete_task` | Delete a task |
83
+
84
+ ### Search & Views
85
+ | Tool | Description |
86
+ |------|-------------|
87
+ | `tf_search` | Full-text search across tasks |
88
+ | `tf_due_soon` | Tasks due within N days |
89
+ | `tf_overdue` | All overdue tasks |
90
+
91
+ ### Service Lifecycle
92
+ | Tool | Description |
93
+ |------|-------------|
94
+ | `tf_serve_status` | Check if web server is running |
95
+ | `tf_serve_start` | Start web server in background |
96
+ | `tf_serve_stop` | Stop web server |
97
+
98
+ ## MCP Registration
99
+
100
+ Add to `~/.claude.json`:
101
+
102
+ ```json
103
+ {
104
+ "mcpServers": {
105
+ "taskflow": {
106
+ "type": "stdio",
107
+ "command": "path/to/venv/bin/python",
108
+ "args": ["-m", "src.server"],
109
+ "cwd": "path/to/taskflow"
110
+ }
111
+ }
112
+ }
113
+ ```
114
+
115
+ ## Web UI
116
+
117
+ Start the web server on port 8787:
118
+
119
+ ```bash
120
+ make serve # foreground, Ctrl-C to stop
121
+ make dev # with auto-reload
122
+ make status # check if running
123
+ make stop # stop the server
124
+ ```
125
+
126
+ Or manage via MCP tools from Claude Code — ask Claude to "start the taskflow server."
127
+
128
+ ## Database
129
+
130
+ SQLite with WAL mode. Tables: `projects`, `sections`, `tasks`, `tags`, `task_tags`, `tasks_fts` (FTS5).
131
+
132
+ Database is created automatically on first run via `db.init_db()`.
133
+
134
+ ## License
135
+
136
+ PolyForm Noncommercial 1.0.0 — free for personal and noncommercial use.
@@ -0,0 +1,111 @@
1
+ # taskflow-agent
2
+
3
+ Lightweight project and task manager with MCP tools for Claude Code.
4
+
5
+ SQLite backend, 20 MCP tools, web UI with embedded AI chat, and a FastAPI REST API. Built as a self-hosted Asana replacement optimized for AI-assisted workflows.
6
+
7
+ ## Features
8
+
9
+ - **20 MCP tools** — full project/task CRUD, search, views, service lifecycle management
10
+ - **Web UI** — dark-theme SPA with project boards, task details, inline editing
11
+ - **AI chat** — embedded Claude chat with workspace awareness and tool access
12
+ - **FTS search** — full-text search across task names and notes
13
+ - **Asana import** — bulk import from Asana CSV exports
14
+ - **Service management** — start/stop the web server via MCP tools or Makefile
15
+
16
+ ## Quick Start
17
+
18
+ ```bash
19
+ pip install -e ".[web]"
20
+
21
+ # Start the MCP server (for Claude Code)
22
+ taskflow
23
+
24
+ # Start the web UI
25
+ make serve # foreground
26
+ taskflow-web # via CLI
27
+ ```
28
+
29
+ ## MCP Tools
30
+
31
+ ### Projects
32
+ | Tool | Description |
33
+ |------|-------------|
34
+ | `tf_list_projects` | List active projects with task counts |
35
+ | `tf_get_project` | Get project with sections and tasks |
36
+ | `tf_create_project` | Create a new project |
37
+ | `tf_update_project` | Update project fields |
38
+ | `tf_archive_project` | Archive a project |
39
+
40
+ ### Sections
41
+ | Tool | Description |
42
+ |------|-------------|
43
+ | `tf_create_section` | Add a section to a project |
44
+ | `tf_update_section` | Update section fields |
45
+ | `tf_move_section` | Reorder a section |
46
+
47
+ ### Tasks
48
+ | Tool | Description |
49
+ |------|-------------|
50
+ | `tf_list_tasks` | List tasks with filters |
51
+ | `tf_get_task` | Get task details with subtasks and tags |
52
+ | `tf_create_task` | Create a task |
53
+ | `tf_update_task` | Update task fields |
54
+ | `tf_complete_task` | Mark task completed |
55
+ | `tf_reopen_task` | Reopen a completed task |
56
+ | `tf_move_task` | Move task between projects/sections |
57
+ | `tf_delete_task` | Delete a task |
58
+
59
+ ### Search & Views
60
+ | Tool | Description |
61
+ |------|-------------|
62
+ | `tf_search` | Full-text search across tasks |
63
+ | `tf_due_soon` | Tasks due within N days |
64
+ | `tf_overdue` | All overdue tasks |
65
+
66
+ ### Service Lifecycle
67
+ | Tool | Description |
68
+ |------|-------------|
69
+ | `tf_serve_status` | Check if web server is running |
70
+ | `tf_serve_start` | Start web server in background |
71
+ | `tf_serve_stop` | Stop web server |
72
+
73
+ ## MCP Registration
74
+
75
+ Add to `~/.claude.json`:
76
+
77
+ ```json
78
+ {
79
+ "mcpServers": {
80
+ "taskflow": {
81
+ "type": "stdio",
82
+ "command": "path/to/venv/bin/python",
83
+ "args": ["-m", "src.server"],
84
+ "cwd": "path/to/taskflow"
85
+ }
86
+ }
87
+ }
88
+ ```
89
+
90
+ ## Web UI
91
+
92
+ Start the web server on port 8787:
93
+
94
+ ```bash
95
+ make serve # foreground, Ctrl-C to stop
96
+ make dev # with auto-reload
97
+ make status # check if running
98
+ make stop # stop the server
99
+ ```
100
+
101
+ Or manage via MCP tools from Claude Code — ask Claude to "start the taskflow server."
102
+
103
+ ## Database
104
+
105
+ SQLite with WAL mode. Tables: `projects`, `sections`, `tasks`, `tags`, `task_tags`, `tasks_fts` (FTS5).
106
+
107
+ Database is created automatically on first run via `db.init_db()`.
108
+
109
+ ## License
110
+
111
+ PolyForm Noncommercial 1.0.0 — free for personal and noncommercial use.
@@ -0,0 +1,50 @@
1
+ [build-system]
2
+ requires = ["hatchling"]
3
+ build-backend = "hatchling.build"
4
+
5
+ [project]
6
+ name = "taskflow-agent"
7
+ version = "0.1.0"
8
+ description = "Lightweight project and task manager with MCP tools for Claude Code"
9
+ readme = "README.md"
10
+ requires-python = ">=3.10"
11
+ license = "PolyForm-Noncommercial-1.0.0"
12
+ authors = [
13
+ { name = "Henry Chien" },
14
+ ]
15
+ keywords = ["mcp", "task-manager", "project-manager", "claude", "ai"]
16
+ classifiers = [
17
+ "Development Status :: 4 - Beta",
18
+ "Intended Audience :: Developers",
19
+ "License :: Other/Proprietary License",
20
+ "Programming Language :: Python :: 3",
21
+ "Programming Language :: Python :: 3.10",
22
+ "Programming Language :: Python :: 3.11",
23
+ "Programming Language :: Python :: 3.12",
24
+ "Topic :: Office/Business :: Scheduling",
25
+ ]
26
+ dependencies = [
27
+ "mcp>=1.0.0",
28
+ ]
29
+
30
+ [project.optional-dependencies]
31
+ web = ["fastapi", "uvicorn", "python-dotenv"]
32
+
33
+ [project.scripts]
34
+ taskflow = "src.server:main"
35
+ taskflow-web = "src.web:main"
36
+
37
+ [project.urls]
38
+ Repository = "https://github.com/henrysouchien/taskflow-agent"
39
+
40
+ [tool.hatch.build.targets.wheel]
41
+ packages = ["src"]
42
+
43
+ [tool.hatch.build.targets.sdist]
44
+ include = [
45
+ "src/",
46
+ "static/",
47
+ "Makefile",
48
+ "pyproject.toml",
49
+ "README.md",
50
+ ]
File without changes