> 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
