Exciting release!Introducing "safe npm". Learn more
Log inDemoInstall


Package Overview
File Explorer

Advanced tools


A linter for BrightScript


Version published
Weekly downloads
decreased by-93.85%

Weekly downloads





  • Fix dependency in linter API




Node version Npm version Npm downloads Travis branch

Website | Configuring | Rules | Contributing | Reporting Bugs | Code of Conduct

Wist is a linter for identifying and reporting errors found in Brightscript code. It helps you identify errors before you upload code to your Roku.

For full documentation, please see our user and developer guides here

How does it compare to other tools?

Wist has one of the most accurate and complete implementations of the Brightscript grammar available right now. It focuses reporting not just syntax violations, but reporting patterns that are likely to result in errors.


Join us in the #tooling channel on the Roku Developers Slack.


  • NodeJS

  • (Optional) JDK8


The easiest and best way to use Wist, is through our editor clients.

You can install them through their respective package managers and work out of the box with a .wistrc.json included in your root directory.

Standalone installation

We recommend taking this approach if you if you want to include Wist as part of your project's build pipeline. Wist is available via as an NPM package and can be installed like so:

$ npm install -g @willowtreeapps/wist

It can be invoked directly using the wist command

$ wist yourfile.brs

Wist can also be installed locally to the project

$ npm install @willowtreeapps/wist --save-dev

After that, you can run Wist in your project's root directory like this:

$ ./node_modules/.bin/wist yourfile.brs


wist [options] file.brs [file.brs] [dir] Basic configuration: -i, --init Initialize Wist -c, --config String Use specified configuration file -f, --format String Output format - either: compact, json, stylish, unix, or visualstudio - default: stylish -v, --verbose Verbose logging -h, --help Show help

To get started linting your Brightscript project, you should then setup a wist configuration file:

$ wist --init

This will generate a .wistrc.json file in your directory. In it, you'll see some rules configured like this:

{ "rules": { "no-stop": ["error"], "no-print": ["warn"] } }

These configures the sort of errors that the rules engine reports back. There are several other rules that can be configured. See the documentation for the full list.

Once your .wistrc.json has been configured to your liking. Invoke wist on your Brightscript file.

$ wist yourfile.brs

Wist format (experimental)

Wist format or wist-fmt is an opinionated code formatter built into Wist. It works by traversing your codes abstract syntax tree and reprinting it with the appropriate whitespace after. wist-fmt can be run in a pre-commit hook, or in your CI environments to ensure your codebase has a consistent code style.

Usage: wist-fmt [options] [file.brs] -i, --indent Int Number of tokens to indent --use-tabs Indent with tabs -h, --help Show help -v, --version Show version information

You can invoke the formatter in the terminal using the wist-fmt command.

wist-fmt yourfile.brs

You can specify the number of spaces used to indent your code using the -i flag.

wist-fmt -i 2 yourfile.brs

Contributing to Wist

Contributions are welcome. Please see the Contributing guidelines.

Wist has adopted a Code of Conduct defined by the Contributor Covenant. Please see our Code of Conduct as well as our Contributing Guidelines for more information.


  1. How do I run wist on directory or path?

    You can use the directory syntax to pass a pattern. For example, if I wanted lint all the *.brs files in my sources directory, I can do so with this command.

    $ wist source/*.brs
  2. Wist takes a really long time on large projects

    The reason for this is because Wist currently doesn't run lints in parallel. A work around for this would be to run multiple intances of wist in parallel. For example,

    $ find source/ -name *.brs | xargs -P 8 wist
  3. How do I install the latest development version

    You can do this through npm. Please note that while the latest development version might have bug fixes and enhancements, it's not guaranteed to be stable until release.

    You have to first uninstall the current version of Wist you have installed

    $ npm uninstall -g @willowtreeapps/wist

    Then install from the git repository using,

    $ npm install -g git+https://github.com/willowtreeapps/wist.git

    You can also install a version based on a specific commit

    $ npm install -g git+https://github.com/willowtreeapps/wist.git#[commit hash]

    For example,

    $ npm install -g git+https://github.com/willowtreeapps/wist.git#de1e2b6


Copyright 2018 WillowTree Inc. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.



Last updated on 19 Sep 2018

Did you know?

Socket installs a Github app to automatically flag issues on every pull request and report the health of your dependencies. Find out what is inside your node modules and prevent malicious activity before you update the dependencies.

Install Socket
support@socket.devSocket SOC 2 Logo


  • Package Issues
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.

  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc