Mephisto is a browser extension that enables next best move analysis and automated gameplay on Chess.com and Lichess.

Getting Started

Click Mephisto's icon to open its popup window and automatically scrape the current page for a chess position to analyze. For ease of use, pin Mephisto in chrome's extensions menu. Click the puzzle icon to the right of Chrome's address bar. Find "Mephisto Chess Extension" and click the pin icon to the right of it.

You may notice that when you click outside of Mephisto's popup window, the popup will lose focus and close. To prevent this, right-click the pinned icon and click 'Inspect Popup'.

For more information, see Getting Started.

How to Develop Locally

Set up a local install:

1. Clone the repo
2. Navigate to chrome://extensions through the Chrome address bar
3. Enable developer mode
4. Click on "Load unpacked" and select the cloned repo folder
5. Mephisto Chess Extension is now installed

Test a code change:

1. Navigate to chrome://extensions
2. Reload Mephisto Chess Extension
3. Reload the webpage you want to test on
4. Test the changes

For technical details, see Technical Overview.

How to Contribute

Thank you for your interest in contributing to Mephisto! There are many ways to contribute, and we appreciate all of them.

Ways to Contribute:

• Help contribute ideas to Mephisto
• Help identify and document bugs with Mephisto
• Implement requested features through PRs
• Fix identified bugs through PRs