hub / github.com/Sho0pi/tickli
github.com/Sho0pi/tickli @v0.0.3
Chat with this repo
135 symbols
392 edges
40 files
10 documented · 7%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README
Tickli 📋✨
A modern command line interface for TickTick task management
What is Tickli?
Tickli is a powerful CLI tool that lets you manage your TickTick tasks and projects directly from your terminal. Stay productive without leaving your command line!
Features
- 🚀 Create and manage tasks right from your terminal
- 📂 Organize tasks into projects
- 📅 Set dates, priorities, and tags
- 🔄 Complete and uncomplete tasks
- 🔍 Filter and search your tasks
- 🔐 Secure OAuth authentication
Installation
Using Homebrew
brew tap sho0pi/homebrew-tap
brew install tickli
Download from Releases
You can also download prebuilt binaries from the GitHub releases page.
Quick Start
# Initialize and authenticate with TickTick
tickli init
# List available projects
tickli project list
# Switch to a project
tickli project use "Work Tasks"
# Add a new task
tickli task add "Finish documentation for project X"
# Add a high priority task due tomorrow
tickli task add "Important meeting" --priority high --date "tomorrow at 2pm"
# List your tasks
tickli task list
# Complete a task
tickli task complete <task-id>
Key Commands
| Command | Description |
|---|---|
tickli init |
Set up authentication with TickTick |
tickli project list |
Show all your projects |
tickli project use |
Switch active project context |
tickli add |
Quickly add a new task |
tickli task list |
List tasks in current project |
tickli task show |
View task details |
tickli task complete |
Mark a task as complete |
Interactive TUI Experience (Coming Soon!)
Roadmap 🗺️
- [x] Basic task management
- [x] Project management
- [x] Authentication
- [x] Advanced date/time handling and timezone support
- [ ] Interactive modes for all commands
- [ ] Subtask management
- [ ] TUI interface with bubbletea
- [ ] Task filtering by multiple criteria
- [ ] Offline mode and syncing
- [ ] Custom views (Kanban, etc.)
Documentation
For complete documentation on all available commands:
tickli --help
Or check out the full documentation.
Contributing
Contributions are welcome! Please see CONTRIBUTING.md for details.
Extension points exported contracts — how you extend this code
ProjectsProvider (Interface)(no doc) [1 implementers]
internal/completion/completion.go
Core symbols most depended-on inside this repo
Stringcalled by 18
internal/types/project/kind.go
Sprint
called by 10
internal/types/project/color.go
GetProjectDescription
called by 5
internal/utils/utils.go
GetTaskDescription
called by 5
internal/utils/utils.go
LoadToken
called by 5
internal/config/config.go
ListProjects
called by 4
internal/completion/completion.go
NewClient
called by 4
internal/api/client.go
String
called by 3
internal/types/project/view_mode.go
Shape
Languages
Go100%
Modules by API surface
internal/api/client.go16 symbols
cmd/project/interactive.go9 symbols
cmd/task/list.go8 symbols
internal/types/project/view_mode.go7 symbols
internal/types/project/color.go7 symbols
internal/config/config.go7 symbols
internal/types/ticktick_time.go6 symbols
internal/types/task/priority.go6 symbols
internal/types/project/kind.go6 symbols
internal/utils/utils.go4 symbols
internal/types/task/status.go4 symbols
internal/types/output_format.go4 symbols
For agents
$ claude mcp add tickli \
-- python -m otcore.mcp_server <graph>