a.html

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <style>body {
  background-color: var(--background);
  color: var(--foreground);
  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif;
  line-height: 1.6;
  min-width: 1200px;
  padding: 2rem;
}

h1,
h2,
h3,
h4,
h5,
h6 {
  color: var(--keyword);
  margin-top: 1.5em;
}

h1 {
  font-size: 2.2em;
  border-bottom: 2px solid var(--border);
  padding-bottom: 0.3em;
}

h2 {
  font-size: 1.8em;
  border-bottom: 1px solid var(--border);
  padding-bottom: 0.2em;
}

h3 {
  font-size: 1.4em;
}

h4,
h5,
h6 {
  color: var(--constant);
}

a {
  color: #66aaff;
  text-decoration: none;
}

a:hover {
  text-decoration: underline;
}

code {
  background-color: var(--surface);
  color: var(--function);
  padding: 0.2em 0.4em;
  border-radius: 4px;
}

pre {
  background-color: var(--surface);
  color: var(--foreground);
  padding: 1em;
  overflow-x: auto;
  border: 1px solid var(--border);
  border-radius: 6px;
  white-space: pre-wrap;
  /* Wrap long lines */
  word-wrap: break-word;
  overflow-y: hidden;
  /* Disable vertical scrolling */
}

pre code {
  background: none;
  padding: 0;
  color: inherit;
  display: block;
}

pre::-webkit-scrollbar {
  display: none;
  /* Hide scrollbar */
}

blockquote {
  border-left: 4px solid var(--type);
  background-color: var(--surface);
  padding: 0.8em 1em;
  color: var(--comment);
  margin: 1em 0;
}

ul,
ol {
  padding-left: 2em;
}

li::marker {
  color: var(--function);
}

table {
  border-collapse: collapse;
  width: 100%;
  margin: 1em 0;
}

th,
td {
  border: 1px solid var(--border);
  padding: 0.6em 1em;
}

th {
  background-color: var(--surface);
  color: var(--function);
}

tr:nth-child(even) {
  background-color: var(--surface);
}

hr {
  border: none;
  border-top: 1px solid var(--border);
  margin: 2em 0;
}



:root {
  --keyword: #CBA6F7;
  --function: #89B4FA;
  --type: #89DCEB;
  --constant: #F38BA8;
  --comment: #7F849C;
  --foreground: #CDD6F4;
  
  /* UI Colors */
  --background: #1E1E2E;
  --surface: #2A2A3A;
  --border: #45475A;
}
</style>
</head>
<body>
  <div align="center">
<img src="https://placehold.co/900x200/0f0f0f/ffffff?text=tache-cli&font=montserrat" alt="Project Banner" width="100%" />
<br/>
<p><img src="https://img.shields.io/badge/version-1.0.0-blue?style=for-the-badge" alt="Version" />
<img src="https://img.shields.io/badge/coverage-00%25-brightgreen?style=for-the-badge" alt="Coverage" /><br />
<a href="https://github.com/fevunge/task-management-cli/issues"><img src="https://img.shields.io/github/issues/fevunge/task-management-cli" alt="Issues" /></a>
<a href="https://github.com/fevunge/task-management-cli/stargazers"><img src="https://img.shields.io/github/stars/fevunge/task-management-cli" alt="Stars" /></a></p>
<br/>
<img src="./assets/icon/tache.png" width="100px"/> 
<h1>tache-cli</h1>
<h3><em>An enterprise-grade command-line task management system—for developers and other CLI’s users.</em></h3>
<p>The system manages tasks with priorities, due dates, tags, and interdependencies, using SQLite persistence via Drizzle ORM<br />
and integrates with Ollama for intelligent prioritization suggestions based on the user’s historical patterns.</p>
<br/>
<p><a href="https://fevunge.github.io/live-demo"><strong>Live Demo</strong></a>  · 
<a href="https://fevunge.github.io/repo-name-placeholder/"><strong>Documentation</strong></a>  · 
<a href="https://github.com/fevunge/article-placeholder"><strong>Article</strong></a>  · </p>
</div>
<hr />
<h2>Table of Contents</h2>
<ul>
<li><a href="#-overview">Overview</a></li>
<li><a href="#-features">Features</a></li>
<li><a href="#-tech-stack">Tech Stack</a></li>
<li><a href="#-getting-started">Getting Started</a>
<ul>
<li><a href="#prerequisites">Prerequisites</a></li>
<li><a href="#installation">Installation</a></li>
<li><a href="#environment">Environment</a></li>
</ul>
</li>
<li><a href="#-usage">Usage</a></li>
<li><a href="#-api-reference">API Reference</a></li>
<li><a href="#-screenshots">Screenshots</a></li>
<li><a href="#-contributing">Contributing</a></li>
<li><a href="#-authors">Authors</a></li>
<li><a href="#-acknowledgements">Acknowledgements</a></li>
<li><a href="#-license">License</a></li>
</ul>
<hr />
<h2>Overview</h2>
<p>Tache CLI is a lightweight task, project, and calendar management system built for real-world use, designed for programmers and IT and technology professionals in general who prefer to work directly from the command line.<br />
It enables fast and organized task and project management through a terminal-centric experience,
with support for priorities, deadlines, reminders, alarms, and smart notifications.</p>
<p>Tache CLI can be integrated with Large Language Models (LLMs), transforming task and project management into an intelligent workflow assistant.</p>
<hr />
<h2>Features</h2>
<ul>
<li>
<p><strong>Task CRUD &amp; Validation</strong><br />
Full create, read, update, and delete operations for tasks, with strict schema validation powered by Zod<br />
— ensuring all inputs are type-safe and well-formed before hitting the database.</p>
</li>
<li>
<p><strong>Project &amp; Subtask Management</strong><br />
Support for hierarchical task structures, allowing users to create projects with nested subtasks,<br />
and manage dependencies between them (e.g., a subtask cannot be marked complete until its parent task is done).</p>
</li>
<li>
<p><strong>Task Scheduling</strong><br />
Tasks can be scheduled for future execution using cron job syntax or the <a href="https://fevunge.github.io/blog/taimplex"><strong><code>taimplex</code></strong></a> syntax,
allowing users to set recurring or one-time deadlines that trigger background jobs automatically.</p>
</li>
<li>
<p><strong>Real-Time Notifications</strong><br />
An event-driven notification system using Node.js <code>EventEmitter</code><br />
that fires alerts when tasks are created, updated, completed, or overdue — without polling.</p>
</li>
<li>
<p><strong>Export / Import</strong><br />
Users can export their full task list (or filtered subsets) to JSON, CSV, or raw SQL,<br />
and re-import from any of those formats — useful for backups, migrations, or data sharing.</p>
</li>
<li>
<p><strong>Fuzzy Search with Levenshtein Distance</strong><br />
A search engine that finds resources even with typos or partial matches,<br />
using the Levenshtein distance algorithm to rank results by similarity.</p>
</li>
<li>
<p><strong>Undo / Redo</strong><br />
A command history stack that lets users undo or redo any destructive action (delete, bulk update, etc.) within the current session.</p>
</li>
<li>
<p><strong>Custom Norminette <a href="https://gitlab.com/tachecli_g/lentte">Lentte</a></strong><br />
A project-specific linting ruleset that enforces text style conventions similar to 42’s norminette
— length limits, naming rules, and forbidden patterns — with clear error messages and auto-fix suggestions.</p>
</li>
<li>
<p><strong>Detailed Logging <a href="https://gitlab.com/tachecli_g/vlogging">Vlogging</a></strong><br />
A structured logging module - <strong><code>vlogging</code></strong> - inspired by 42’s <code>ft_printf</code> project,<br />
with log levels, timestamps, color-coded output, and optional verbose mode for debugging internals.</p>
</li>
<li>
<p><strong>Memory &amp; Resource Tracking</strong><br />
A lightweight tracker that monitors heap usage, open handles,<br />
and DB connection counts throughout the process lifecycle
— surfaced via a <code>--stats</code> CLI flag.</p>
</li>
</ul>
<hr />
<h2>Tech Stack</h2>
<table>
<thead>
<tr>
<th>Layer</th>
<th>Technology</th>
</tr>
</thead>
<tbody>
<tr>
<td><strong>Core Language</strong></td>
<td>TypeScript</td>
</tr>
<tr>
<td><strong>Frontend</strong></td>
<td>Commander.js, Klaur</td>
</tr>
<tr>
<td><strong>Compiler</strong></td>
<td>Bun</td>
</tr>
<tr>
<td><strong>Database</strong></td>
<td>SQLite, DrizzleORM</td>
</tr>
<tr>
<td><strong>DevOps</strong></td>
<td>Docker, Jenkins</td>
</tr>
<tr>
<td><strong>Testing</strong></td>
<td>Vitest</td>
</tr>
<tr>
<td><strong>Log</strong></td>
<td><a href="https://gitlab.com/tachecli_g/vlogging">Vlogging</a></td>
</tr>
<tr>
<td><strong>Linter</strong></td>
<td><a href="https://gitlab.com/tachecli_g/lentte">Lentte</a></td>
</tr>
</tbody>
</table>
<hr />
<h2>Getting Started</h2>
<h3>Prerequisites</h3>
<p>For local development, test, and contribution purposes, you will need to have the following software installed on your machine.</p>
<pre style="background-color:#2a2a3a;"><code class="language-bash"><span style="color:#89b4fa;">bun</span><span style="color:#cdd6f4;"> = 1.3.14
</span><span style="color:#89b4fa;">pnpm </span><span style="color:#cdd6f4;">&gt;= 10.33.0
</span><span style="color:#89b4fa;">docker </span><span style="color:#cdd6f4;">&gt;= 29.3.0  </span><span style="color:#7f849c;"># optional
</span></code></pre>
<h3>Installation</h3>
<p><strong>1. Clone the repository</strong></p>
<pre style="background-color:#2a2a3a;"><code class="language-bash"><span style="color:#89b4fa;">git</span><span style="color:#cdd6f4;"> clone https://github.com/fevunge/tache-cli.git
</span><span style="color:#89b4fa;">cd</span><span style="color:#cdd6f4;"> tache-cli
</span></code></pre>
<p><strong>2. Install dependencies</strong></p>
<pre style="background-color:#2a2a3a;"><code class="language-bash"><span style="color:#89b4fa;">make</span><span style="color:#cdd6f4;"> setup
</span></code></pre>
<p><strong>2.1. Compile JS code</strong></p>
<pre style="background-color:#2a2a3a;"><code class="language-bash"><span style="color:#89b4fa;">make</span><span style="color:#cdd6f4;"> compile
</span></code></pre>
<p><strong>2.2. Build executable</strong></p>
<pre style="background-color:#2a2a3a;"><code class="language-bash"><span style="color:#89b4fa;">make 
</span></code></pre>
<p><strong>3. Set up environment variables</strong></p>
<pre style="background-color:#2a2a3a;"><code class="language-bash"><span style="color:#89b4fa;">make</span><span style="color:#cdd6f4;"> env
</span></code></pre>
<p><strong>5. Run at development env</strong></p>
<pre style="background-color:#2a2a3a;"><code class="language-bash"><span style="color:#89b4fa;">bun</span><span style="color:#cdd6f4;"> dev --help      </span><span style="color:#7f849c;"># to run TypeScript code
</span><span style="color:#89b4fa;">bun</span><span style="color:#cdd6f4;"> start --help    </span><span style="color:#7f849c;"># to run compiled JavaScript code
</span></code></pre>
<p><strong>6. Run compiled project</strong></p>
<pre style="background-color:#2a2a3a;"><code class="language-bash"><span style="color:#89b4fa;">chmod</span><span style="color:#cdd6f4;"> u+x ./bin/tache
</span><span style="color:#cdd6f4;">
</span><span style="color:#89b4fa;">./bin/tache</span><span style="color:#cdd6f4;"> --help 
</span></code></pre>
<p><strong>7. Install at your local machine</strong></p>
<pre style="background-color:#2a2a3a;"><code class="language-bash"><span style="color:#89b4fa;">make</span><span style="color:#cdd6f4;"> install
</span><span style="color:#cdd6f4;">
</span><span style="color:#89b4fa;">tache</span><span style="color:#cdd6f4;"> --help
</span></code></pre>
<hr />
<h3>Environment</h3>
<p>Create a <code>.env</code> file in the root directory. See <code>.env.example</code> for reference.</p>
<table>
<thead>
<tr>
<th>Variable</th>
<th>Description</th>
<th>Required</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>RESOURCE_PATH</code></td>
<td>Path to resource files</td>
<td>[x]</td>
</tr>
<tr>
<td><code>LLM_API_KEY</code></td>
<td>API key for LLM integration</td>
<td>[x]</td>
</tr>
</tbody>
</table>
<hr />
<h2>Usage</h2>
<h3>Basic Example</h3>
<pre style="background-color:#2a2a3a;"><code class="language-shell"><span style="color:#cdd6f4;"># Create a new task
</span><span style="color:#cdd6f4;">$ tache create &quot;Finish project report&quot; --priority high --due &quot;2024-07-01&quot;
</span></code></pre>
<h3>Advanced Example</h3>
<pre style="background-color:#2a2a3a;"><code class="language-shell"><span style="color:#cdd6f4;"># Create a project with subtasks and dependencies
</span><span style="color:#cdd6f4;">$ tache create &quot;Launch Marketing Campaign&quot; --type project
</span><span style="color:#cdd6f4;">
</span><span style="color:#cdd6f4;">$ tache create &quot;Design Ad Creatives&quot; --parent &quot;Launch Marketing Campaign&quot; --due &quot;2024-06-15&quot;
</span><span style="color:#cdd6f4;">
</span><span style="color:#cdd6f4;">$ tache create &quot;Set Up Email List&quot; --parent &quot;Launch Marketing Campaign&quot; --due &quot;2024-06-20&quot;
</span><span style="color:#cdd6f4;">
</span><span style="color:#cdd6f4;">$ tache create &quot;Schedule Social Media Posts&quot; --parent &quot;Launch Marketing Campaign&quot; --due &quot;2024-06-25&quot;
</span></code></pre>
<blockquote>
<p>💡 <strong>Tip:</strong> Check the <a href="./examples"><code>/examples</code></a> directory for more comprehensive usage patterns.</p>
</blockquote>
<hr />
<h2>API Reference</h2>
<h3>Full API reference available at <a href="./docs/api.md"><code>/docs/api.md</code></a></h3>
<ul>
<li><strong><code>GET /api/v1/resource</code></strong>: Returns a list of resources.</li>
<li><strong><code>POST /api/v1/resource</code></strong>: Creates a new resource.</li>
</ul>
<p>Full API reference available at <a href="./docs/api.md"><code>/docs/api.md</code></a></p>
<hr />
<h2>Screenshots</h2>
<div align="center">
<table>
<thead>
<tr>
<th>Dashboard</th>
<th>Detail View</th>
<th>Mobile</th>
</tr>
</thead>
<tbody>
<tr>
<td><img src="https://placehold.co/380x220/1a1a2e/ffffff?text=Dashboard" alt="Dashboard" /></td>
<td><img src="https://placehold.co/380x220/16213e/ffffff?text=Detail+View" alt="Detail" /></td>
<td><img src="https://placehold.co/180x320/0f3460/ffffff?text=Mobile" alt="Mobile" /></td>
</tr>
</tbody>
</table>
</div>
<hr />
<h2>Contributing</h2>
<p>Contributions are what make the open source community incredible.<br />
Any contributions you make are <strong>greatly appreciated</strong>.</p>
<ol>
<li><strong>Fork</strong> the repository</li>
<li>Create your feature branch: <code>git checkout -b feat/feature-or-bugfix</code></li>
<li>Commit your changes: <code>git commit -m 'feat: add some amazing feature or fix a bug'</code></li>
<li>Push to the branch: <code>git push origin feat/feature-or-bugfix</code></li>
<li>Open a <strong>Pull Request</strong></li>
</ol>
<p>Please read <a href="./CONTRIBUTING.md">CONTRIBUTING.md</a> if it exists for more details on our code of conduct, and the process for submitting pull requests.</p>
<p>Please, follow <a href="https://www.conventionalcommits.org/">Conventional Commits</a>:</p>
<pre style="background-color:#2a2a3a;"><code><span style="color:#cdd6f4;">feat(scope):     New feature
</span><span style="color:#cdd6f4;">fix(scope):      Bug fix
</span><span style="color:#cdd6f4;">docs(scope):     Documentation update
</span><span style="color:#cdd6f4;">style(scope):    Formatting (no logic change)
</span><span style="color:#cdd6f4;">refactor(scope): Code refactoring
</span><span style="color:#cdd6f4;">test(scope):     Adding tests
</span><span style="color:#cdd6f4;">chore(scope):    Maintenance tasks
</span></code></pre>
<hr />
<h2>Authors</h2>
<div align="center">
<table>
<thead>
<tr>
<th align="center"><img src="https://github.com/fevunge.png" width="80px" style="border-radius:50%"/></th>
</tr>
</thead>
<tbody>
<tr>
<td align="center"><strong>Fernando Vunge</strong></td>
</tr>
<tr>
<td align="center"><a href="https://github.com/fevunge"><img src="https://img.shields.io/badge/GitHub-100000?style=flat&amp;logo=github" alt="GitHub" /></a> <a href="https://linkedin.com/in/fevunge"><img src="https://img.shields.io/badge/LinkedIn-0077B5?style=flat&amp;logo=linkedin" alt="LinkedIn" /></a> <a href="https://twitter.com/fevunge"><img src="https://img.shields.io/badge/Twitter-1DA1F2?style=flat&amp;logo=twitter" alt="Twitter" /></a></td>
</tr>
</tbody>
</table>
</div>
<hr />
<div align="center">
<p>Made with 🧠 by <a href="https://github.com/fevunge">fevunge</a></p>
<p>⭐ <strong>Star this repo</strong> if you found it useful or interesting!</p>
</div>
<h2>Acknowledgements</h2>
<ul>
<li><a href="https://github.com/">Awesome Library</a> — Used for X feature</li>
<li><a href="https://dribbble.com/">Design Inspiration</a> — UI/UX reference</li>
<li><a href="https://stackoverflow.com/">Community Resource</a> — Problem-solving guidance</li>
<li><a href="https://github.com/">Open Source Project</a> — Architectural patterns</li>
</ul>
<hr />
<h2>License</h2>
<p>Distributed under the <strong>MIT License</strong>.</p>

</body>
</html>