diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e0bc275
--- /dev/null
+++ b/README.md
@@ -0,0 +1,76 @@
+# GitHub Issue Downloader
+
+This project is a command-line tool that fetches GitHub issue data and reconstructs it in Markdown or HTML format. It includes features such as rendering Markdown in comments, displaying user avatars, and a dark mode toggle in HTML output.
+
+## Features
+
+- Fetch GitHub issue and comments
+- Render Markdown in issues and comments
+- Display user avatars
+- Dark mode toggle for HTML output
+
+## Prerequisites
+
+- Go 1.23 or later
+- Internet connection to access the GitHub API
+
+## Installation
+
+1. Clone the repository:
+
+   ```sh
+   git clone https://f0rk.systems/reso/tools_issue_cli.git
+   ```
+
+2. Change to the project directory:
+
+   ```sh
+   cd tools_issue_cli§
+   ```
+
+3. Build the project:
+   ```sh
+   go build -o tools_issue_cli
+   ```
+
+## Usage
+
+### Fetching and Outputting an Issue
+
+You can use the tool to fetch a GitHub issue and output it in either Markdown or HTML format.
+
+#### Fetch and Output as Markdown
+
+To fetch an issue and output it as Markdown:
+
+```sh
+./tools_issue_cli fetch --url https://github.com/owner/repo/issues/1 --output issue.md --format markdown
+```
+
+#### Fetch and Output as HTML
+
+To fetch an issue and output it as HTML:
+
+```sh
+./tools_issue_cli fetch --url https://github.com/owner/repo/issues/1 --output issue.html --format html
+```
+
+### Command-Line Options
+
+- `--url`: The URL of the GitHub issue to fetch.
+- `--output`: The file path to write the output (optional). If not provided, the output is printed to the console.
+- `--format`: The output format (`markdown` or `html`). Defaults to `markdown`.
+
+## Example
+
+### Fetch an Issue and Output as Markdown
+
+```sh
+./tools_issue_cli fetch --url https://github.com/dnnyxyz/dnnyxyz.github.io/issues/1 --output issue.md --format markdown
+```
+
+### Fetch an Issue and Output as HTML
+
+```sh
+./tools_issue_cli fetch --url https://github.com/dnnyxyz/dnnyxyz.github.io/issues/1 --output issue.html --format html
+```