KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #ai-agents #dsh-plugin #codex #developer-tools #claude-code #windows #cli #desktop-app #typescript #rust #ai-agent

sketchup-console-plus

★ 45 Open GitHub ↗

A better Ruby Console and IDE for integrated development in SketchUp.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<img alt="logo" src="./src/ae_console/images/icon_64.png" align="left" /><h1>Ruby Console+</h1>

This is a powerful Ruby Console with IDE features like code highlighting, autocompletion and a code editor.  
It lets you open multiple independent instances of the console and remembers the command history over sessions.

## Requirements

- **SketchUp 2017+**  
  This [extension](https://extensions.sketchup.com/en/content/ruby-console) (originating from 2012 & 2014) has been completely rebuilt to take advantage of modern technologies (the new HtmlDialog with modern JavaScript support, Ruby 2.0).

## Installation

- Go to the [releases page](https://github.com/Aerilius/sketchup-console-plus/releases/) (↑) and download the latest .rbz file. Open in SketchUp _Window → Extension Manager_ and select the .rbz file.

- Alternatively, you can install the contents of the `src` directory into your plugins folder.

## Usage

Menu: <kbd>Window</kbd> → <kbd>Ruby Console+</kbd>

There are two modes (<kbd>Ctrl</kbd>-<kbd>Tab ↹</kbd>):

- <img alt="Console" src="./src/ae_console/images/console.png" align="left" width="24" /> The **console** is a command line interface to try out codes and inspect return values.  
  With the <kbd>Enter ↵</kbd> key, code will be evaluated (use <kbd>⇧ Shift</kbd>-<kbd>Enter ↵</kbd> for line breaks, or configure it in the settings menu).

- <img alt="Editor" src="./src/ae_console/images/editor.png" align="left" width="24" /> The **editor** is a full-featured text editor. Here you turn code into a script and save it as a file.

### Features

- **Tutorials**: You don't know any programming? No problem, because SketchUp is the coolest opportunity to get started and it's super easy with the famous "Try Ruby" interactive tutorial that is included with this extension.

- **Autocompletion** and **doc tooltips**: Intelligent live autocompletion tells you not only which methods you can call next on a reference but provides you also with detailed info on how to correctly use them. Use <kbd>Tab ↹</kbd> to accept a suggestion.

- **Entity inspection**: Hover an entity or point in the console output and you will see it highlighted in the model.

- <img alt="Select" src="./src/ae_console/images/select.png" align="left" width="24" /> Get a **reference to an entity** in the model by picking it with the pointer.  
  No more selecting and doing `Sketchup.active_model.selection[0]`. By holding the <kbd>Ctrl</kbd> key when the main window is focused, you can select points instead of entities and by holding the <kbd>⇧ Shift</kbd> key you can turn on inferencing.

- Remembers which scripts you reload and **reloads scripts** automatically whenever they are changed.

- <img alt="Clear" src="./src/ae_console/images/clear.png" align="left" width="24" /> Clear the console (<kbd>Ctrl</kbd>-<kbd>&nbsp;L&nbsp;</kbd>)

- <img alt="Help" src="./src/ae_console/images/help.png" align="left" width="24" /> Open online **documentation** for the currently focused word (_beta_) (<kbd>Ctrl</kbd>-<kbd>&nbsp;Q&nbsp;</kbd>)

- <img alt="Menu" src="./src/ae_console/images/menu.png" align="left" width="24" /> Menu with preferences

- **Binding**: An advanced feature that allows to step into an object or class and call methods or access instance variables as if you were locally inside of the class source definition. Try to set binding to `Math` and you can directly call math functions like `sqrt` without NameError.

## Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/Aerilius/sketchup-console-plus/issues.

## Development

You can find [documentation in the docs](./docs/README.md) folder.

This project requires `ruby`, `ruby-bundler` and `npm`.

First, run `bundle install` to install requirements.

Run `bundle exec rake test` to run the tests.

To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version and push git commits and tags.

To build a new installation package , run `bundle exec rake build_rbz`.

## License

This extension is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

sketchup-console-plus

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README