> For the complete documentation index, see [llms.txt](https://chatcounter.augystudios.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chatcounter.augystudios.com/hello.md).

# Hello! 👋

## Welcome to the *Countr Usage Documentation*!

### What is Countr (fka Chat Counter)?

Countr is a Discord bot designed to track word usage, generate leaderboards, and easily provide server statistics. Whether you're curious about who the chattiest member is or the most used words in your guild, Countr has you covered.

***

### 💡 What Can Countr Do?

#### 🧾 Stats & Leaderboards

* `/serverstats` – View word totals, most-used words, and top chatters
* `/lb global` – Global top users by message count
* `/lb guild` – Guild-specific leaderboard

#### 🔤 Word Analysis

* `/topwords overall` – Top 10 words across all servers
* `/topwords guild` – Top 10 words in a specific server
* `/topwords user` – Most used words by a user

#### 📚 Dictionary Insights

* `/wordstats dictionary` – Percentage of dictionary vs non-dictionary words
* `/wordstats leastused` – Least used words
* `/wordstats search` – Stats for a specific word
* `/wordstats dump` – Full word data dump with pagination

#### 🧠 Advanced Word Breakdown

* `/topdict` – Top dictionary words globally or per guild
* `/nondict` – Top non-dictionary words globally or per guild

#### 🛠 Developer Tools *(Bot Owner Only)*

* `/dev restart` – Restart the bot
* `/dev reload` – Reload cogs
* `/dev eval` – Evaluate Python snippets
* `/dev sync` – Slash command sync
* `/dev stats` – View bot performance
* `/dev sessions` – View session logs

#### ℹ️ General Info

* `/ping` – Bot latency
* `/hello` – Learn more about the bot and join the support server
* `/help` – View commands by category
* `/botinfo`, `/serverinfo`, `/userinfo` – Get info about the bot, server, and user

***

### Commands

{% content-ref url="/pages/1Nkfx5aWPP6Dcrgw8yds" %}
[General Commands](/general.md)
{% endcontent-ref %}

{% content-ref url="/pages/kSqPyVKS8EL4McUspARL" %}
[Information Commands](/info.md)
{% endcontent-ref %}

{% content-ref url="/pages/B7d3R6UMeHrBfWzUl5xU" %}
[Statistics Commands](/stats.md)
{% endcontent-ref %}

{% content-ref url="/pages/WR6jWXXzdCdKQBrz0cVs" %}
[Developer-Only Commands](/dev.md)
{% endcontent-ref %}

***

### 🐞 Known Issues

| Issue                                | Description                                                            |
| ------------------------------------ | ---------------------------------------------------------------------- |
| `/wordstats dump` slow on large data | Dumping a lot of word data may take a while to paginate.               |
| Unknown usernames                    | Users who are no longer in mutual guilds may appear as `Unknown User`. |

***

### ❓ FAQ

**Q: Who can access developer commands like `/dev reload` or `/eval`?**\
A: Only the bot owner can use those commands.

**Q: Can I get stats for my own messages?**\
A: Yes! Use `/topwords user` , as it defaults to you, or you can specify someone else.

**Q: I changed my server name — will the stats reflect that?**\
A: Yes. Names are pulled live from Discord whenever you run a command.

**Q: Are messages tracked in DMs?**\
A: No, tracking is only done inside the servers the bot is added to.

**Q: What’s a “dictionary word”?**\
A: Words found in the reference dictionary file used by the bot (using the`american-english` wordlist from Linux servers).

***

## Contact Us

* Email <augy@augystudios.com> to report any bugs or send feedback.
* 🧃 [Support Server](https://discord.gg/H4YYsgkYSa)
* 💻 [Built by Augy Studios](https://augystudios.com)

{% hint style="success" %}
[Buy Augy a Coffee](https://donate.stripe.com/28o2akeAr3hv0DK6oo) or [Support Augy Monthly](https://donate.stripe.com/6oEbKUdwn9FTgCI7st)!
{% endhint %}

{% hint style="warning" %}
Is the bot not responding? Check its status [here](https://pages.statusbot.us/id/873989298507120690)!
{% endhint %}

***

*Made with ❤️ by Augy Studios © 2025 All Rights Sniffed •* [Augy Studios](https://augystudios.com/)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://chatcounter.augystudios.com/hello.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.