FreeTodo — AI-Powered Todo Management
An AI-driven todo app that auto-manages your personal task context, breaking down complex goals into actionable steps.
Evidence: The repository provides no permission model, user confirmation mechanism, data flow description, or sensitive data handling details. The dependency list includes many third-party packages, but no security audit or vulnerability scanning evidence. External effects (e.g., network requests, file system access) are not clearly stated. Rollback mechanisms are not mentioned. Source attribution is only via contributor badges and community links in README, but publisher identity is unverified. Therefore all trust criteria score 0.
Evidence: The project description in README and pyproject.toml are inconsistent (README says FreeTodo, pyproject says LifeTrace), but the code structure is largely consistent. A uv.lock file exists, but its integrity is not verified. Failure messages are not documented. Therefore self-consistency scores 1, dependency availability scores 1, and failure messages score 0.
Evidence: README describes target users (individuals) and multiple usage scenarios (task management, calendar, AI assistant). Capability boundaries are partially described (e.g., AI task breakdown, multi-view calendar). Trigger precision is not clear (e.g., when AI triggers task extraction). Environment fit is addressed with installation instructions for Windows/macOS/Linux, but no specific environment limitations are mentioned. Therefore each scores 1.
Evidence: README provides a clear project structure, installation steps, and quick start guide. Naming is mostly stable (e.g., lifetrace, free-todo-frontend). Examples and FAQ are missing. Known limitations are not explicitly listed. License is FreeU Community License, but full text is not provided. Version is 0.1.2 in pyproject.toml, but no changelog. Maintenance responsibility is indicated via contribution guidelines and community links. Therefore information architecture scores 2, install notes score 2, and others score 1.
Evidence: Output usability is described in README, but no actual output examples are provided. Marginal value is suggested by AI task breakdown and calendar integration, but not quantified. Cost-benefit is not addressed; many dependencies but no performance or resource data. Therefore each scores 1.
Evidence: Feature claims in README are not backed by specific implementation details or test evidence. Test files exist but cover only some functionality, and no test results are provided. Cross-source corroboration is lacking, relying solely on this repository. Fact-inference separation is partially done; README distinguishes completed and planned features, but inferences are not clearly labeled. Therefore each scores 1.
- Publisher identity is unverified; use with caution.
- README and pyproject.toml descriptions are inconsistent, which may affect understanding.
- Many dependencies without security audit pose supply chain risks.
- No data flow or permission documentation, potential privacy concerns.
What does this agent do, and when should you use it?
FreeTodo is an AI-powered intelligent todo management application with a frontend-backend separation architecture: a FastAPI (Python) backend and a Next.js (React + TypeScript) frontend, plus an Electron desktop wrapper. It uses conversational AI to automatically decompose complex projects into manageable subtasks and extracts actionable todos from chat responses. Key features include hierarchical tasks, priorities, tags, deadlines, a multi-view calendar (day/week/month) with drag-and-drop scheduling, and a multi-panel UI with dark/light themes. The app fully supports English and Chinese. Data is stored locally using SQLite and ChromaDB (a vector database) for AI features. It is part of the FreeU project, currently focusing on the input layer, collecting user daily information and converting it into todos.
FreeTodo provides a RESTful API backend, located in the lifetrace/ directory, started via python -m lifetrace.server on port 8001. The frontend dev server is in free-todo-frontend/, installed with pnpm and run with pnpm dev, automatically detecting the backend port. AI features: contextual task breakdown via guided questionnaires, extraction of tasks from AI chat responses, and suggestions based on your current todo context. The calendar supports drag-and-drop scheduling and quick todo creation from time slots. Data is persisted in SQLite (in lifetrace/data/lifetrace.db) and embeddings in ChromaDB. It also includes an Electron desktop app with native notifications and system tray.
- A professional wants to break down a large project like 'learn a new language' into daily actionable subtasks guided by an AI questionnaire.
- A freelancer uses the week view of the calendar to drag todos onto time slots and plan their week visually.
- A team member creates tasks through the AI chat interface and extracts action items from meeting notes without manual entry.
- A privacy-conscious user wants a self-hosted todo app with local storage (SQLite) to avoid cloud dependency.
- A developer wants to extend the todo functionality by adding custom panels to the frontend or use the FastAPI backend to build custom integrations.
What are this agent's strengths and limitations?
- AI-enabled task breakdown automatically converts complex goals into actionable steps.
- Separation of FastAPI and Next.js makes the codebase modular and extensible.
- Multi-view calendar with drag-and-drop scheduling enhances time management.
- Bilingual support (English/Chinese) and theming, plus Electron desktop app.
- Clear roadmap towards proactive services, showing evolution potential.
- Still in early development (v0.1), may be unstable, and AI features depend on external LLM APIs.
- Requires managing two services (Python backend and Node.js frontend), increasing deployment complexity.
- Local SQLite storage lacks cloud sync, making multi-device collaboration difficult.
- License is FreeU Community License with additional commercial terms, requiring careful evaluation.
How do you install or deploy this agent?
Clone the repo: git clone https://github.com/FreeU-group/FreeTodo. Backend dependencies: Install Python 3.12 and uv (use curl -LsSf https://astral.sh/uv/install.sh | sh on macOS/Linux, or irm https://astral.sh/uv/install.ps1 | iex on Windows). In the repo root, run uv sync to install dependencies, then activate the virtual environment (source .venv/bin/activate on macOS/Linux, .venv\Scripts\activate on Windows). Frontend dependencies: Need Node.js 20+ and pnpm; go to free-todo-frontend/ and run pnpm install.
How do you use this agent?
Start the backend: in the activated virtual environment, run python -m lifetrace.server. On first run, config.yaml is auto-generated from default_config.yaml; edit lifetrace/config/config.yaml to configure settings, including AI prompt templates in lifetrace/config/prompt.yaml. Start the frontend: in free-todo-frontend/, run pnpm dev; it automatically detects the backend port and sets up a proxy. Open the browser to the frontend URL (usually http://localhost:3001). To use AI features, you need an LLM provider (e.g., OpenAI) API key, configured in config.yaml.
FAQ
Can FreeTodo work completely offline?
What configuration is needed to use AI features?
lifetrace/config/config.yaml, and you can adjust prompts in prompt.yaml.Is there mobile support?
How can I back up my task data?
lifetrace/data/lifetrace.db; you can back up that file to preserve your tasks.