Description
Terminal Tickets is a command-line style ticket management system. This manual provides information on available commands and navigation.
Commands
cd /tickets
Navigate to tickets list
cd /labels
Navigate to labels list
cd ..
Go back to previous page
ls
List items in current directory
ls -la
List items with details
cat [ticket_id]
View a ticket's details
vim [ticket_id]
Edit a ticket
rm [ticket_id]
Delete a ticket
touch new_ticket
Create a new ticket
touch new_label
Create a new label
echo "text" >> file
Append an update to a ticket
grep --status=VALUE
Filter tickets by status
grep --priority=VALUE
Filter tickets by priority
grep --points=VALUE
Filter tickets by story points
grep --assignee=USERNAME
Filter tickets by assignee
grep --unassigned
Show unassigned tickets
grep --help
Show grep command help
Ticket Statuses
Tickets can have the following statuses:
none
Default status for new tickets
future
Planned for future implementation
todo
Ready to be worked on
in progress
Currently being worked on
testing
In testing phase
QA
In quality assurance
completed
Work is complete
You can filter tickets by status using the filter form or the grep --status=VALUE command.
Ticket Priorities
Tickets can have the following priorities:
lowest
Lowest priority, can be addressed later
low
Low priority, should be addressed when time permits
medium
Medium priority, default for new tickets
high
High priority, should be addressed soon
highest
Highest priority, should be addressed immediately
blocker
Blocking progress, must be addressed immediately
You can filter tickets by priority using the filter form or the grep --priority=VALUE command.
Story Points
Tickets can be assigned story points to indicate their complexity and effort:
-
No points assigned (0)
1
Very simple task
2
Simple task
3
Moderate task
5
Significant task
8
Complex task
13
Very complex task
21
Extremely complex task
You can filter tickets by points using the filter form or the grep --points=VALUE command.
Navigation
Use the terminal-style links to navigate through the system. Commands are displayed as clickable links that perform the associated action.
You can also type commands directly in the terminal input box below. Try typing 'ls', 'cd /tickets', 'touch new_ticket', etc.
Styling
The interface is designed to mimic a terminal environment with:
- Dark background and light text
- Monospace fonts
- ASCII art decorations
- Command-line style navigation
Version
Terminal Tickets v1.0.0