Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/FranksGP/Gestor_de_tareas/llms.txt

Use this file to discover all available pages before exploring further.

By the end of this page you will have Gestor de Tareas running locally, you will have created your first task, and you will know how to view it in the console. The entire process takes under a minute and requires nothing beyond a working Python 3.13+ installation — no package manager, no virtual environment setup, and no configuration files to edit.
1

Clone the repository

Download the project from GitHub and navigate into the directory. The repository is self-contained: the only file you need to run the app is index.py.
git clone https://github.com/FranksGP/Gestor_de_tareas.git && cd Gestor_de_tareas
Once inside the directory you will see a single Python file, index.py. The Tareas.json data file does not exist yet — it will be created automatically when you add your first task.
2

Run the script

Launch the interactive menu by passing index.py directly to the Python interpreter. No entry-point script or __main__ package is needed.
python index.py
The application immediately prints the main menu and waits for your input:
Gestor de Tareas
1. Agregar tarea
2. Listar tareas
3. Marcar tarea como completada
4. Eliminar tarea
5. Salir
Seleccione una opción:
The menu re-prints after every action, so you can perform multiple operations in a single session without restarting the script.
3

Add your first task

Type 1 and press Enter to select Agregar tarea. The application will prompt you for a title and then a description. Both are stored as plain strings — there is no length limit enforced by the code.Here is an example terminal session adding a task called Mi primera tarea:
Seleccione una opción: 1
Título de la tarea: Mi primera tarea
Descripción de la tarea: Esta es mi primera tarea en Gestor de Tareas
Tarea agregada exitosamente.
Under the hood, agregarTask("Mi primera tarea", "Esta es mi primera tarea en Gestor de Tareas") appends the following object to the list and calls guardarTask to write it to Tareas.json:
{
    "titulo": "Mi primera tarea",
    "descripcion": "Esta es mi primera tarea en Gestor de Tareas",
    "completed": false
}
The file is written immediately — if you open Tareas.json in your editor right now you will see the saved task.
4

List your tasks

Type 2 and press Enter to select Listar tareas. The listarTask function loads Tareas.json, iterates over every task, and prints each one with a 1-based index, its title, description, and a status badge.
Seleccione una opción: 2
1. Mi primera tarea - Esta es mi primera tarea en Gestor de Tareas [✘ Pendiente]
The status badge changes once you mark a task complete:
  • [✘ Pendiente] — the task has not been completed yet ("completed": false)
  • [✔ Completada] — the task has been marked done ("completed": true)
If no tasks have been saved yet, listarTask prints "No hay tareas disponibles." instead of an empty list.
When you are done, select option 5 — Salir to exit the program gracefully. The application prints "Saliendo..." and returns you to your shell prompt. You do not need to interrupt the process with Ctrl+C — all your tasks are already saved to Tareas.json and will be there the next time you run python index.py.

​
Next steps

Now that you have added and listed your first task, explore the two most-used follow-up actions:

Adding Tasks

Learn more about the agregarTask function, how tasks are structured in Tareas.json, and tips for writing clear titles and descriptions.

Completing Tasks

Walk through using tareaCompletada to mark tasks done by index, and understand how the completed flag is persisted across sessions.

Build docs developers (and LLMs) love

Get started for freeTalk to us