Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including ccurl with all npm packages installed. Try it out:

ccurl lists no main file and has no index.js, so it can't be directly required. If this is a mistake, please let us know. It may however contain internal files that you can require manually:

// require("ccurl/[??]")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

ccurl v0.1.2

CouchDB command-line helper

ccurl - 'couchdb curl'

If you use CouchDB, then you can access everything using curl. The trouble is, that it if you are using an authenticated, hosted service such as Cloudant's, then your credentials appear on your command-line history and there is a lot of typing. e.g.

  curl ''

With ccurl, this becomes:

  ccurl /database/12345678

Or adding a document with curl:

  curl -X POST -H 'Content-type:application/json' '' -d'{"a":1,"b":2}'

With ccurl, this becomes:

  ccurl -X POST /database -d'{"a":1,"b":2}'


ccurl required Node.js (and npm). Simply type:

  npm install -g ccurl

You may need to prepend 'sudo' to this.

Storing your credentials

Your CouchDB credentials are taken from an environment variable "COUCH_URL". This can be set in your console with

  export COUCH_URL=""

or this line can be added to your "~/.bashrc" or "~/.bash_profile" file.

Using ccurl

  • all command-line switches are passed through to curl
  • instead of passing through a full url, pass through a relative url
  • if the url is omitted, then a relative url of "/" is assumed
  • the content-type of 'application-json' is added for you if you don't already provide a content type


Add a database

  > ccurl -X PUT /newdatabase

Add a document

  > ccurl -X POST /newdatabase -d'{"a":1,"b":2}'

Get a document

  > ccurl /newdatabase/005fa466b4f690ccad7b4d194f071bbe

Get ten documents

  > ccurl '/newdatabase/_all_docs?limit=10&include_docs=true' {"total_rows":1,"offset":0,"rows":[{"id":"005fa466b4f690ccad7b4d194f071bbe","key":"005fa466b4f690ccad7b4d194f071bbe","value":{"rev":"1-25f9b97d75a648d1fcd23f0a73d2776e"},"doc":{"_id":"005fa466b4f690ccad7b4d194f071bbe","_rev":"1-25f9b97d75a648d1fcd23f0a73d2776e","a":1,"b":2}}]}

Remove a database

  > ccurl -X DELETE /newdatabase

Other curl command-line parameters work too

  ccurl -h
  ccurl -v

Using ccurl with jq

jq is a command-line json utility, and as ccurl returns JSON, it can be piped in-line to colour the JSON:

 ccurl '/newdatabase/_all_docs?limit=10&include_docs=true' | jq '.total_rows'

or to process or select the data:

 ccurl '/newdatabase/_all_docs?limit=10&include_docs=true' | jq '.'


RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free