KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #claude-code #codex #developer-tools #dsh-plugin #ai-agent #mcp #deepseek-harness #windows #open-source

tooling-force.com

★ 64 Open GitHub ↗

Work with force.com Tooling/Meta API from various command line tools and editor plugins like vim-force.com.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# A command line utility for working with salesforce.com Tooling & Metadata API

Primary goal of tooling-force.com is to provide the means of interacting with
force.com Medatata API and Tooling API from various command line tools and editor plugins like [vim-force.com](https://github.com/neowit/vim-force.com).

## DESCRIPTION

Current version of this tool is similar in functionality to [Force.com Migration Tool](http://wiki.developerforce.com/page/Force.com_Migration_Tool) with one important difference - it is designed with scripting languages (shell, .bat, etc) in mind. All operations can be done by constructing appropriate command line, no messing with XML is required. Results are returned in easy to parse formats.

## FEATURES

### Non project specific:

- Retrieve - metadata retrieval
- Deploy (all, specific files)
- Run Tests (and report code coverage)
- Describe Metadata - load full metadata description (result is provided in JSON format)
- List Metadata - list members of specific metadata type (e.g. list all Apex Classes)
- ExecuteAnonymous - run arbitrary piece of Apex Code
- ListConflicts - display list of local files which have been updated in SFDC since last deployment
- Execute SOQL query

### Project specific  
Also supported a "project like" mode - where relevant metadata about deployments and retrievals is cached in a set of local files and makes possible operations like:

- Deploy modified files
- List Modified files
- Conflict checking before deployment (test if file(s) you are trying to deploy have been modified by someone else in SFDC since your last Refresh or Deployment.
- list candidates for [Apex](http://youtu.be/u-6JQNuWRdE) and [SOQL](http://youtu.be/rzqgXV3Gx0s) auto-completion (note: current version is "work in progress")
- find definition (go-to-symbol) in apex classes  
- login using username/password or oauth2

## System requirements

[Java](http://java.com/download) JDK/JRE, Version 8 or greater

## Installation

Download lastest .jar file from [releases page](https://github.com/neowit/tooling-force.com/releases).
Assuming .jar file name is `tooling-force.com-0.1.jar` you can run it like so:

java -jar tooling-force.com-0.1.jar
    
This will display main help and list of supported commands/actions. In order to get help for specific command run it like so:

java -jar tooling-force.com-0.1.jar --help=<action-name>

### Proxy
When connection requires proxy it can be passed as java -D params or as tooling-force.com.jar command line params, e.g. 
 
	java -jar tooling-force.com-0.1.jar --action=refresh ... --http.proxyHost=localhost --http.proxyPort=8888 --http.proxyUser=some --http.proxyPassword=pass

### CREDITS

Author: Andrey Gavrikov

## Legal stuff

License: LGPL v3 <http://www.gnu.org/licenses/>

Third-Party Licenses:  
* [Force.com Web Service Connector (WSC)](https://github.com/forcedotcom/wsc) - see [LICENSE.md](https://github.com/forcedotcom/wsc/blob/master/LICENSE.md)  
* [Apache Commons-logging](http://commons.apache.org/proper/commons-logging/) - [Apache 2.0 License](http://www.apache.org/licenses/)  
* [Akka](http://akka.io/) - [Apache 2.0 License](http://www.apache.org/licenses/)  
* [ANTLR 4](http://www.antlr.org/) - [BSD license](http://www.antlr.org/license.html)  
* [spray-json](https://github.com/spray/spray-json) - [Apache 2.0 License](http://www.apache.org/licenses/)  
* [jetty](https://www.eclipse.org/jetty/) - [Apache License 2.0 and Eclipse Public License 1.0](https://www.eclipse.org/jetty/licenses.html)  
* [scala-logging](https://github.com/lightbend/scala-logging) - [Apache License 2.0 and Eclipse Public License 1.0](https://www.eclipse.org/jetty/licenses.html)  
* [Logback](https://logback.qos.ch/license.html) - logback source code and binaries are dual-licensed under the EPL v1.0 and the LGPL 2.1

tooling-force.com

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README