diff --git a/pullrequest/OWNERS b/pullrequest/OWNERS
new file mode 100644
index 0000000000..4642a8a098
--- /dev/null
+++ b/pullrequest/OWNERS
@@ -0,0 +1,4 @@
+approvers:
+- bobcatfish
+- wlynch
+- chmouel
\ No newline at end of file
diff --git a/pullrequest/README.md b/pullrequest/README.md
new file mode 100644
index 0000000000..59ecb55f4a
--- /dev/null
+++ b/pullrequest/README.md
@@ -0,0 +1,195 @@
+# Generic PullRequest interaction
+
+This Task allows a user to interact with an SCM (source control management) system through an abstracted interface
+(implemented uisng [jenkins-x/go-scm](https://github.com/jenkins-x/go-scm)).
+
+* [Install the Task](#install-the-tasks)
+* [Configure the Task](#configure-the-tasks)
+* [Usage](#usage)
+* [PullRequest Image](#pullrequest-image)
+
+_This `Task` works with both public SCM instances and self-hosted/enterprise GitHub/GitLab instances. For a GitHub specific `Task` see [github](../github)._
+
+## Mode: Upload or Download
+
+In `download` mode, this `Task` will look at the state of an existing pull request and populate
+[the `pr` workspace](#workspaces) with the state of the pull request, including
+the `.MANIFEST` file.
+
+If you want to update or delete existing attributes of a PR, running `download`
+first will allow you to use `upload` to make those changes.
+
+In `upload` mode, this `Task` will look at the contents of [the `pr` workspace](#workspaces)
+and compare it to the `.MANIFEST` file (if it exists). Any differences will result
+in requests being made to bring the Pull Request into the state described in the
+workspace.
+
+## Install the Tasks
+
+To install the Task:
+
+```bash
+kubectl apply -f pullrequest/pr.yaml
+```
+
+## Configuring the Tasks
+
+### Parameters
+
+* `mode` (_Required_)- The [mode ("upload" or "download")](#mode-upload-or-download)
+* `url` (_Required_) - The complete URL of the Pull Request, e.g. `https://github.com/bobcatfish/catservice/pull/16`
+* `provider` (_Required_) - The type of SCM system, currently `github` or `gitlab`
+* `secret-key-ref` (_Required_) - The name of a secret key containing
+  [the token required for SCM requests](#permissions)
+* `insecure-skip-tls-verify` (_Default: `"false"`_) - If `"true"`, certificate validation will be disabled
+
+### Workspaces
+
+The `pr` workspace holds all the data about any labels, statuses, comments you want to update.
+
+The files in the `pr` workspace represent the state of [the configured PR](#parameters),
+i.e. the current state when using [download mode](#mode-uploapr-sample-add-comment-q26vrd-or-download) and/or
+the desired state when using [upload mode](#mode-upload-or-download).
+
+The structure of the workspace is:
+
+* `/labels/<label>` - These are empty files, the name of the file is the name of the label
+  (URL encode non-URL safe characters).
+* `/status/<status>` - These are [json files that represent statuses](#statuses)
+* `/comments/<comment>` - These are [json files that represent comments](#comments)
+* `base.json` - Information about the base commit of the PR
+* `head.json` - Information about the head commit of the PR
+* `pr.json` - Information about the PR
+
+When populated via [download](#mode-upload-or-download), the file `.MANIFEST` is
+populated and used to represent the current state of the Pull Request; before
+[upload](#mode-upload-or-download) mutates the the Pull Request it will compare
+the contents of the `pr` workspace to this file to determine what has changed.
+
+_See [pr-example](.pr-example) for an example of a `pr` workspace poulated with comments, labels,
+and statuses (.MANIFEST file not included)._
+
+##### statuses
+
+Each status file is a json file containing a dictionary with the following keys:
+
+* `Label`: The name of the status
+* `Desc`: (_optional_) A string to associate with the current state of the status
+* `Target`: (_optional_) A link to where more information can be found (e.g. link to logs)
+* `State`: The state of the status, [valid options](https://github.com/jenkins-x/go-scm/blob/68aae24e07bc56f684a2f2b9da451b2386ca8545/scm/const.go#L29-L50) are:
+  * `unknown`
+  * `pending`
+  * `running`
+  * `success`
+  * `failure`
+  * `cancelled`
+  * `expected`
+  * `error`
+
+```json
+{
+  "State": "pending",
+  "Label": "pull-tekton-pipeline-build-tests",
+  "Desc": "Job triggered.",
+  "Target": "https://tekton-releases.appspot.com/build/tekton-prow/pr-logs/pull/tektoncd_pipeline/995/pull-tekton-pipeline-build-tests/1146102490727452672/"
+}
+```
+
+_See [pr-example/status](.pr-example/status) for examples._
+
+##### comments
+
+The format of the files in `comments` depends on whether
+[upload or download mode is being used](#modes-upload-or-download).
+
+_[pipeline#2168](https://github.com/tektoncd/pipeline/issues/2168)_
+
+###### upload mode comments
+
+When uploading comments, the content of the file is used as the body of the comment.
+
+###### download mode comments
+
+Each comment file is a json file containing a dictionary that represents a comment
+in a vendor agnostic way [with these keys](https://github.com/jenkins-x/go-scm/blob/68aae24e07bc56f684a2f2b9da451b2386ca8545/scm/issue.go#L54-L61):
+
+* `ID` - Identifier of the comment
+* `Body` - Body of the comment
+* `Link` - URL that links to the comment
+* `Created` - [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) conforming string
+* `Updated` - [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) conforming string
+* `Author` - Another dictionary representing the user who made the comment
+  [with the _optional_ keys](https://github.com/jenkins-x/go-scm/blob/68aae24e07bc56f684a2f2b9da451b2386ca8545/scm/user.go#L14-L22)
+  * `Login` - User's handle
+  * `Name` - User's name
+  * `Email` - User's email
+  * `Avatar` - Link to user's avatar image
+  * `Link` - Link to user's profile
+  * `Created` - [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) conforming string
+  * `Updated` - [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) conforming string
+
+_See [pr-example/comments](.pr-example/comments) for examples of GitHub comments._
+
+## Usage
+
+### Permissions
+
+The Task will need access to an opaque secret containing a token to use when making
+requests to the SCM provider (configured via [the `secret-key-ref` param](#parameters)).
+The secret is expected to contain a key called `token` which contains the auth token as a
+base64 encoded string, for example:
+
+```yaml
+apiVersion: v1
+kind: Secret
+metadata:
+  name: github-auth-token
+type: Opaque
+data:
+  token: dG9rZW4=
+```
+
+### Running the Task
+
+Example `TaskRun` that would run this `Task` in [download mode](#modes-upload-or-download):
+
+```yaml
+apiVersion: tekton.dev/v1beta1
+kind: TaskRun
+metadata:
+  generateName: some-task-run-
+spec:
+  taskRef:
+  - name: pull-request
+  workspaces:
+  - name: pr
+    persistentVolumeClaim:
+      claimName: shared-task-storage
+  params:
+  - name: mode
+    value: download
+  - name: url
+    value: https://github.com/bobcatfish/catservice/pull/16
+  - name: provider
+    value: github
+  - name: secret-key-ref
+    value: some-secret
+```
+
+[sample/add-comment.yaml](sample/add-comment.yaml) contains an example of a `PipelineRun`
+which creates a `Pipeline` to exercise this Task's upload and download functionality.
+
+To try out the sample (note that it expects the existence of a [secret](#permissions) called
+'webhook-secret`):
+
+```bash
+kubectl apply -f pullrequest/sample/static.yaml
+kubectl create -f pullrequest/sample/add-comment.yaml
+```
+
+## PullRequest Image
+
+This Task was created to have feature parity with
+[the Tekton Pipelines PullRequest PipelineResource](https://github.com/tektoncd/pipeline/blob/master/docs/resources.md#pull-request-resource)
+and uses [the pullrequest-init image](https://github.com/tektoncd/pipeline/tree/master/cmd/pullrequest-init)
+which is built and published as part of [Tekton Pipeline releases](https://github.com/tektoncd/pipeline/releases).
\ No newline at end of file
diff --git a/pullrequest/pr-example/README.md b/pullrequest/pr-example/README.md
new file mode 100644
index 0000000000..7a264b0c2b
--- /dev/null
+++ b/pullrequest/pr-example/README.md
@@ -0,0 +1,8 @@
+# pullrequest-init examples
+
+This directory serves as an example of the pull request payloads you can expect
+from the pull request pipeline resource.
+
+See
+https://github.com/tektoncd/pipeline/blob/master/docs/resources.md#pull-request-resource
+for more documentation.
diff --git a/pullrequest/pr-example/base.json b/pullrequest/pr-example/base.json
new file mode 100644
index 0000000000..5cc296a0f3
--- /dev/null
+++ b/pullrequest/pr-example/base.json
@@ -0,0 +1,22 @@
+{
+  "Ref": "master",
+  "Sha": "723b9a9d560bdf4dc8fc6f697d53f662d3454ac8",
+  "Repo": {
+    "ID": "146641150",
+    "Namespace": "tektoncd",
+    "Name": "pipeline",
+    "FullName": "tektoncd/pipeline",
+    "Perm": {
+      "Pull": false,
+      "Push": false,
+      "Admin": false
+    },
+    "Branch": "master",
+    "Private": false,
+    "Clone": "https://github.com/tektoncd/pipeline.git",
+    "CloneSSH": "git@github.com:tektoncd/pipeline.git",
+    "Link": "https://github.com/tektoncd/pipeline",
+    "Created": "2018-08-29T18:21:55Z",
+    "Updated": "2019-12-04T17:26:42Z"
+  }
+}
diff --git a/pullrequest/pr-example/comments/505233618.json b/pullrequest/pr-example/comments/505233618.json
new file mode 100644
index 0000000000..8d6029ac33
--- /dev/null
+++ b/pullrequest/pr-example/comments/505233618.json
@@ -0,0 +1,16 @@
+{
+  "ID": 505233618,
+  "Body": "/retest",
+  "Author": {
+    "Login": "wlynch",
+    "Name": "",
+    "Email": "",
+    "Avatar": "https://avatars3.githubusercontent.com/u/1844673?v=4",
+    "Link": "",
+    "Created": "0001-01-01T00:00:00Z",
+    "Updated": "0001-01-01T00:00:00Z"
+  },
+  "Link": "https://github.com/tektoncd/pipeline/pull/995#issuecomment-505233618",
+  "Created": "2019-06-25T00:48:38Z",
+  "Updated": "2019-06-25T00:48:38Z"
+}
diff --git a/pullrequest/pr-example/comments/505476017.json b/pullrequest/pr-example/comments/505476017.json
new file mode 100644
index 0000000000..3c40fd58ec
--- /dev/null
+++ b/pullrequest/pr-example/comments/505476017.json
@@ -0,0 +1,16 @@
+{
+  "ID": 505476017,
+  "Body": "> Looks good to me, question though : right now it's up to the user to write github status or not right (with this PR) ? Do we envision some \"automation\" around that ?\r\n\r\nYup! Great question, I'd love to source more ideas around this. The straight-forward answer would be to provide a runner binary that would wrap test execution and transform status codes and stdout/stderr to the pull request object.\r\n\r\nIs there any work being done around passing state between TaskRuns (e.g. for conditional execution or something similar)?",
+  "Author": {
+    "Login": "wlynch",
+    "Name": "",
+    "Email": "",
+    "Avatar": "https://avatars3.githubusercontent.com/u/1844673?v=4",
+    "Link": "",
+    "Created": "0001-01-01T00:00:00Z",
+    "Updated": "0001-01-01T00:00:00Z"
+  },
+  "Link": "https://github.com/tektoncd/pipeline/pull/995#issuecomment-505476017",
+  "Created": "2019-06-25T14:40:57Z",
+  "Updated": "2019-06-25T14:40:57Z"
+}
diff --git a/pullrequest/pr-example/comments/505482755.json b/pullrequest/pr-example/comments/505482755.json
new file mode 100644
index 0000000000..781789bb41
--- /dev/null
+++ b/pullrequest/pr-example/comments/505482755.json
@@ -0,0 +1,16 @@
+{
+  "ID": 505482755,
+  "Body": "@wlynch yeah we need to think about that, as I think I remember talking about notification as a first-class citizen in Tekton maybe ? (and most likely write on a design docs).\r\n\r\n> Is there any work being done around passing state between TaskRuns (e.g. for conditional execution or something similar)?\r\n\r\n@dibyom ^^ :angel: ",
+  "Author": {
+    "Login": "vdemeester",
+    "Name": "",
+    "Email": "",
+    "Avatar": "https://avatars0.githubusercontent.com/u/6508?v=4",
+    "Link": "",
+    "Created": "0001-01-01T00:00:00Z",
+    "Updated": "0001-01-01T00:00:00Z"
+  },
+  "Link": "https://github.com/tektoncd/pipeline/pull/995#issuecomment-505482755",
+  "Created": "2019-06-25T14:56:09Z",
+  "Updated": "2019-06-25T14:56:09Z"
+}
diff --git a/pullrequest/pr-example/comments/505529049.json b/pullrequest/pr-example/comments/505529049.json
new file mode 100644
index 0000000000..8ceb38871c
--- /dev/null
+++ b/pullrequest/pr-example/comments/505529049.json
@@ -0,0 +1,16 @@
+{
+  "ID": 505529049,
+  "Body": "@wlynch yes, the condition container will have access to some read only metadata. Right now, this is just the pipeline run including the status fields. We could expose this to task runs as well? Or do you need to write additional metadata that needs to be exposed?",
+  "Author": {
+    "Login": "dibyom",
+    "Name": "",
+    "Email": "",
+    "Avatar": "https://avatars2.githubusercontent.com/u/3316877?v=4",
+    "Link": "",
+    "Created": "0001-01-01T00:00:00Z",
+    "Updated": "0001-01-01T00:00:00Z"
+  },
+  "Link": "https://github.com/tektoncd/pipeline/pull/995#issuecomment-505529049",
+  "Created": "2019-06-25T16:50:26Z",
+  "Updated": "2019-06-25T16:50:26Z"
+}
diff --git a/pullrequest/pr-example/comments/505616303.json b/pullrequest/pr-example/comments/505616303.json
new file mode 100644
index 0000000000..d64635b012
--- /dev/null
+++ b/pullrequest/pr-example/comments/505616303.json
@@ -0,0 +1,16 @@
+{
+  "ID": 505616303,
+  "Body": "@dibyom Don't need to write more data, but it would be useful to expose it to TaskRuns to have a binary look for this information and automatically prep PR output as a response. Can you link me to that data and how TaskRuns can access it?",
+  "Author": {
+    "Login": "wlynch",
+    "Name": "",
+    "Email": "",
+    "Avatar": "https://avatars3.githubusercontent.com/u/1844673?v=4",
+    "Link": "",
+    "Created": "0001-01-01T00:00:00Z",
+    "Updated": "0001-01-01T00:00:00Z"
+  },
+  "Link": "https://github.com/tektoncd/pipeline/pull/995#issuecomment-505616303",
+  "Created": "2019-06-25T20:47:32Z",
+  "Updated": "2019-06-25T20:47:32Z"
+}
diff --git a/pullrequest/pr-example/comments/505676294.json b/pullrequest/pr-example/comments/505676294.json
new file mode 100644
index 0000000000..2b3bedb6ea
--- /dev/null
+++ b/pullrequest/pr-example/comments/505676294.json
@@ -0,0 +1,16 @@
+{
+  "ID": 505676294,
+  "Body": "> @wlynch yeah we need to think about that, as I think I remember talking about notification as a first-class citizen in Tekton maybe ? (and most likely write on a design docs).\r\n> \r\n> >\r\n\r\nYeah, I think the automated use-cases for this would fit into something around either \"notification\" or \"conditional execution\".\r\n\r\nWith the conditional execution approach, a pipeline would have a Task that runs on either success or failure and writes the status to Github/Gitlab.",
+  "Author": {
+    "Login": "dlorenc",
+    "Name": "",
+    "Email": "",
+    "Avatar": "https://avatars1.githubusercontent.com/u/1714486?v=4",
+    "Link": "",
+    "Created": "0001-01-01T00:00:00Z",
+    "Updated": "0001-01-01T00:00:00Z"
+  },
+  "Link": "https://github.com/tektoncd/pipeline/pull/995#issuecomment-505676294",
+  "Created": "2019-06-26T01:02:26Z",
+  "Updated": "2019-06-26T01:02:26Z"
+}
diff --git a/pullrequest/pr-example/comments/505798994.json b/pullrequest/pr-example/comments/505798994.json
new file mode 100644
index 0000000000..41bc5cf66f
--- /dev/null
+++ b/pullrequest/pr-example/comments/505798994.json
@@ -0,0 +1,16 @@
+{
+  "ID": 505798994,
+  "Body": "> Yeah, I think the automated use-cases for this would fit into something around either \"notification\" or \"conditional execution\".\r\n\r\nThis could be implemented with the CloudEventPipelineResource as well. \r\nThe setup would be:\r\n- each task that needs to publish test results to the PR has an output resource of type cloudevent, which is sent to a dedicated tekton listener. The TaskRun, including status, is sent as body of the cloudevent.\r\n- an event binding is defined that accepts TaskRun completion events, and triggers a GitHub PR update Task(Run)\r\n- The GitHub PR update taskrun uses the PullRequest resource as input and output, and the metadata in the TaskRun (passed as parameter to the Task) to update GitHub\r\n\r\nThe advantages of using a separate Task/TaskRun are:\r\n- The status of the original Task is not affected by the outcome of the PR update\r\n- It doesn't require conditional execution\r\n- The Task that updates GitHub PRs can be as isolated as we want from the Task that runs the tests, which should make it easier to avoid leaking the GitHub token in logs.",
+  "Author": {
+    "Login": "afrittoli",
+    "Name": "",
+    "Email": "",
+    "Avatar": "https://avatars0.githubusercontent.com/u/2205608?v=4",
+    "Link": "",
+    "Created": "0001-01-01T00:00:00Z",
+    "Updated": "0001-01-01T00:00:00Z"
+  },
+  "Link": "https://github.com/tektoncd/pipeline/pull/995#issuecomment-505798994",
+  "Created": "2019-06-26T09:33:55Z",
+  "Updated": "2019-06-26T09:33:55Z"
+}
diff --git a/pullrequest/pr-example/comments/505890656.json b/pullrequest/pr-example/comments/505890656.json
new file mode 100644
index 0000000000..331958271d
--- /dev/null
+++ b/pullrequest/pr-example/comments/505890656.json
@@ -0,0 +1,16 @@
+{
+  "ID": 505890656,
+  "Body": "/retest",
+  "Author": {
+    "Login": "afrittoli",
+    "Name": "",
+    "Email": "",
+    "Avatar": "https://avatars0.githubusercontent.com/u/2205608?v=4",
+    "Link": "",
+    "Created": "0001-01-01T00:00:00Z",
+    "Updated": "0001-01-01T00:00:00Z"
+  },
+  "Link": "https://github.com/tektoncd/pipeline/pull/995#issuecomment-505890656",
+  "Created": "2019-06-26T14:06:11Z",
+  "Updated": "2019-06-26T14:06:11Z"
+}
diff --git a/pullrequest/pr-example/comments/505923534.json b/pullrequest/pr-example/comments/505923534.json
new file mode 100644
index 0000000000..09c0b16f52
--- /dev/null
+++ b/pullrequest/pr-example/comments/505923534.json
@@ -0,0 +1,16 @@
+{
+  "ID": 505923534,
+  "Body": "> @dibyom Don't need to write more data, but it would be useful to expose it to TaskRuns to have a binary look for this information and automatically prep PR output as a response. Can you link me to that data and how TaskRuns can access it?\r\n\r\nWIP but its a file (`pr-metadata.json`) in `/workspace` for condition containers ([sample](https://gist.github.com/dibyom/95031ac458455ca2b0c25206b7420f24))\r\n\r\nIts exposed to conditional pods at the moment and not regular taskruns. I opened https://github.com/tektoncd/pipeline/issues/1016 to track that.",
+  "Author": {
+    "Login": "dibyom",
+    "Name": "",
+    "Email": "",
+    "Avatar": "https://avatars2.githubusercontent.com/u/3316877?v=4",
+    "Link": "",
+    "Created": "0001-01-01T00:00:00Z",
+    "Updated": "0001-01-01T00:00:00Z"
+  },
+  "Link": "https://github.com/tektoncd/pipeline/pull/995#issuecomment-505923534",
+  "Created": "2019-06-26T15:22:42Z",
+  "Updated": "2019-06-26T15:22:42Z"
+}
diff --git a/pullrequest/pr-example/comments/506032472.json b/pullrequest/pr-example/comments/506032472.json
new file mode 100644
index 0000000000..0780d7c8ae
--- /dev/null
+++ b/pullrequest/pr-example/comments/506032472.json
@@ -0,0 +1,16 @@
+{
+  "ID": 506032472,
+  "Body": "/assign @imjasonh",
+  "Author": {
+    "Login": "wlynch",
+    "Name": "",
+    "Email": "",
+    "Avatar": "https://avatars3.githubusercontent.com/u/1844673?v=4",
+    "Link": "",
+    "Created": "0001-01-01T00:00:00Z",
+    "Updated": "0001-01-01T00:00:00Z"
+  },
+  "Link": "https://github.com/tektoncd/pipeline/pull/995#issuecomment-506032472",
+  "Created": "2019-06-26T20:28:38Z",
+  "Updated": "2019-06-26T20:28:38Z"
+}
diff --git a/pullrequest/pr-example/comments/506082430.json b/pullrequest/pr-example/comments/506082430.json
new file mode 100644
index 0000000000..6ec5d491a1
--- /dev/null
+++ b/pullrequest/pr-example/comments/506082430.json
@@ -0,0 +1,16 @@
+{
+  "ID": 506082430,
+  "Body": "/lgtm",
+  "Author": {
+    "Login": "dlorenc",
+    "Name": "",
+    "Email": "",
+    "Avatar": "https://avatars1.githubusercontent.com/u/1714486?v=4",
+    "Link": "",
+    "Created": "0001-01-01T00:00:00Z",
+    "Updated": "0001-01-01T00:00:00Z"
+  },
+  "Link": "https://github.com/tektoncd/pipeline/pull/995#issuecomment-506082430",
+  "Created": "2019-06-26T23:36:10Z",
+  "Updated": "2019-06-26T23:36:10Z"
+}
diff --git a/pullrequest/pr-example/comments/506082465.json b/pullrequest/pr-example/comments/506082465.json
new file mode 100644
index 0000000000..7ecf3732ad
--- /dev/null
+++ b/pullrequest/pr-example/comments/506082465.json
@@ -0,0 +1,16 @@
+{
+  "ID": 506082465,
+  "Body": "/approve",
+  "Author": {
+    "Login": "dlorenc",
+    "Name": "",
+    "Email": "",
+    "Avatar": "https://avatars1.githubusercontent.com/u/1714486?v=4",
+    "Link": "",
+    "Created": "0001-01-01T00:00:00Z",
+    "Updated": "0001-01-01T00:00:00Z"
+  },
+  "Link": "https://github.com/tektoncd/pipeline/pull/995#issuecomment-506082465",
+  "Created": "2019-06-26T23:36:18Z",
+  "Updated": "2019-06-26T23:36:18Z"
+}
diff --git a/pullrequest/pr-example/comments/507732301.json b/pullrequest/pr-example/comments/507732301.json
new file mode 100644
index 0000000000..a58b050e91
--- /dev/null
+++ b/pullrequest/pr-example/comments/507732301.json
@@ -0,0 +1,16 @@
+{
+  "ID": 507732301,
+  "Body": "/retest",
+  "Author": {
+    "Login": "wlynch",
+    "Name": "",
+    "Email": "",
+    "Avatar": "https://avatars3.githubusercontent.com/u/1844673?v=4",
+    "Link": "",
+    "Created": "0001-01-01T00:00:00Z",
+    "Updated": "0001-01-01T00:00:00Z"
+  },
+  "Link": "https://github.com/tektoncd/pipeline/pull/995#issuecomment-507732301",
+  "Created": "2019-07-02T15:40:32Z",
+  "Updated": "2019-07-02T15:40:32Z"
+}
diff --git a/pullrequest/pr-example/comments/507763725.json b/pullrequest/pr-example/comments/507763725.json
new file mode 100644
index 0000000000..2007f70d3a
--- /dev/null
+++ b/pullrequest/pr-example/comments/507763725.json
@@ -0,0 +1,16 @@
+{
+  "ID": 507763725,
+  "Body": "> There is a binary checked in `cmd/pullrequest-init/pullrequest-init`. Is that intentional?\r\n\r\nGood catch! Removed.",
+  "Author": {
+    "Login": "wlynch",
+    "Name": "",
+    "Email": "",
+    "Avatar": "https://avatars3.githubusercontent.com/u/1844673?v=4",
+    "Link": "",
+    "Created": "0001-01-01T00:00:00Z",
+    "Updated": "0001-01-01T00:00:00Z"
+  },
+  "Link": "https://github.com/tektoncd/pipeline/pull/995#issuecomment-507763725",
+  "Created": "2019-07-02T17:03:47Z",
+  "Updated": "2019-07-02T17:03:47Z"
+}
diff --git a/pullrequest/pr-example/comments/508007084.json b/pullrequest/pr-example/comments/508007084.json
new file mode 100644
index 0000000000..f6cf500c69
--- /dev/null
+++ b/pullrequest/pr-example/comments/508007084.json
@@ -0,0 +1,16 @@
+{
+  "ID": 508007084,
+  "Body": "[APPROVALNOTIFIER] This PR is **APPROVED**\n\nThis pull-request has been approved by: *<a href=\"https://github.com/tektoncd/pipeline/pull/995#pullrequestreview-254634050\" title=\"Approved\">afrittoli</a>*, *<a href=\"https://github.com/tektoncd/pipeline/pull/995#issuecomment-506082465\" title=\"Approved\">dlorenc</a>*, *<a href=\"https://github.com/tektoncd/pipeline/pull/995#pullrequestreview-257350830\" title=\"LGTM\">vdemeester</a>*, *<a href=\"https://github.com/tektoncd/pipeline/pull/995#\" title=\"Author self-approved\">wlynch</a>*\n\nThe full list of commands accepted by this bot can be found [here](https://go.k8s.io/bot-commands).\n\nThe pull request process is described [here](https://git.k8s.io/community/contributors/guide/owners.md#the-code-review-process)\n\n<details >\nNeeds approval from an approver in each of these files:\n\n- ~~[OWNERS](https://github.com/tektoncd/pipeline/blob/master/OWNERS)~~ [dlorenc,vdemeester]\n\nApprovers can indicate their approval by writing `/approve` in a comment\nApprovers can cancel approval by writing `/approve cancel` in a comment\n</details>\n<!-- META={\"approvers\":[]} -->",
+  "Author": {
+    "Login": "tekton-robot",
+    "Name": "",
+    "Email": "",
+    "Avatar": "https://avatars3.githubusercontent.com/u/48335577?v=4",
+    "Link": "",
+    "Created": "0001-01-01T00:00:00Z",
+    "Updated": "0001-01-01T00:00:00Z"
+  },
+  "Link": "https://github.com/tektoncd/pipeline/pull/995#issuecomment-508007084",
+  "Created": "2019-07-03T09:01:16Z",
+  "Updated": "2019-07-03T09:01:16Z"
+}
diff --git a/pullrequest/pr-example/head.json b/pullrequest/pr-example/head.json
new file mode 100644
index 0000000000..e85b0f79aa
--- /dev/null
+++ b/pullrequest/pr-example/head.json
@@ -0,0 +1,22 @@
+{
+  "Ref": "pr",
+  "Sha": "2a8ec1793553186cf2a027a89ae58a2e690509f3",
+  "Repo": {
+    "ID": "184178909",
+    "Namespace": "wlynch",
+    "Name": "pipeline",
+    "FullName": "wlynch/pipeline",
+    "Perm": {
+      "Pull": false,
+      "Push": false,
+      "Admin": false
+    },
+    "Branch": "master",
+    "Private": false,
+    "Clone": "https://github.com/wlynch/pipeline.git",
+    "CloneSSH": "git@github.com:wlynch/pipeline.git",
+    "Link": "https://github.com/wlynch/pipeline",
+    "Created": "2019-04-30T02:40:49Z",
+    "Updated": "2019-11-22T18:44:26Z"
+  }
+}
diff --git a/pullrequest/pr-example/labels/approved b/pullrequest/pr-example/labels/approved
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/pullrequest/pr-example/labels/cla%3A+yes b/pullrequest/pr-example/labels/cla%3A+yes
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/pullrequest/pr-example/labels/lgtm b/pullrequest/pr-example/labels/lgtm
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/pullrequest/pr-example/labels/size%2FL b/pullrequest/pr-example/labels/size%2FL
new file mode 100644
index 0000000000..e69de29bb2
diff --git a/pullrequest/pr-example/pr.json b/pullrequest/pr-example/pr.json
new file mode 100644
index 0000000000..5676ea4da8
--- /dev/null
+++ b/pullrequest/pr-example/pr.json
@@ -0,0 +1,141 @@
+{
+  "Number": 995,
+  "Title": "Add GitHub status updates to Pull Request CRD.",
+  "Body": "This adds support for the GitHub Status API\r\n(https://developer.github.com/v3/repos/statuses/).\r\n\r\nThis accompanies #778 and #895 to complete initial Pull Request support\r\nsupport for GitHub OAuth.\r\n\r\n<!-- 🎉🎉🎉 Thank you for the PR!!! 🎉🎉🎉 -->\r\n\r\n# Changes\r\n\r\nAdds GitHub status fetching and updates to Pull Request CRD.\r\n\r\n# Submitter Checklist\r\n\r\nThese are the criteria that every PR should meet, please check them off as you\r\nreview them:\r\n\r\n- [x] Includes [tests](https://github.com/tektoncd/community/blob/master/standards.md#principles) (if functionality changed/added)\r\n- [x] Includes [docs](https://github.com/tektoncd/community/blob/master/standards.md#principles) (if user facing)\r\n- [x] Commit messages follow [commit message best practices](https://github.com/tektoncd/community/blob/master/standards.md#commit-messages)\r\n\r\n_See [the contribution guide](https://github.com/tektoncd/pipeline/blob/master/CONTRIBUTING.md)\r\nfor more details._\r\n\r\n# Release Notes\r\n\r\n<!--\r\nDoes your PR contain User facing changes?\r\n\r\nIf so, briefly describe them here so we can include this description in the\r\nrelease notes for the next release!\r\n-->\r\n\r\n```\r\nAdds GitHub status fetching and updates to Pull Request CRD.\r\n```\r\n",
+  "Labels": [
+    {
+      "ID": 0,
+      "URL": "https://api.github.com/repos/tektoncd/pipeline/labels/approved",
+      "Name": "approved",
+      "Description": "Indicates a PR has been approved by an approver from all required OWNERS files.",
+      "Color": "abea59"
+    },
+    {
+      "ID": 0,
+      "URL": "https://api.github.com/repos/tektoncd/pipeline/labels/cla:%20yes",
+      "Name": "cla: yes",
+      "Description": "Trying to make the CLA bot happy with ppl from different companies work on one commit",
+      "Color": "0c6a89"
+    },
+    {
+      "ID": 0,
+      "URL": "https://api.github.com/repos/tektoncd/pipeline/labels/lgtm",
+      "Name": "lgtm",
+      "Description": "Indicates that a PR is ready to be merged.",
+      "Color": "6aed75"
+    },
+    {
+      "ID": 0,
+      "URL": "https://api.github.com/repos/tektoncd/pipeline/labels/size/L",
+      "Name": "size/L",
+      "Description": "Denotes a PR that changes 100-499 lines, ignoring generated files.",
+      "Color": "ee9900"
+    }
+  ],
+  "Sha": "2a8ec1793553186cf2a027a89ae58a2e690509f3",
+  "Ref": "refs/pull/995/head",
+  "Source": "pr",
+  "Target": "master",
+  "Base": {
+    "Ref": "master",
+    "Sha": "723b9a9d560bdf4dc8fc6f697d53f662d3454ac8",
+    "Repo": {
+      "ID": "146641150",
+      "Namespace": "tektoncd",
+      "Name": "pipeline",
+      "FullName": "tektoncd/pipeline",
+      "Perm": {
+        "Pull": false,
+        "Push": false,
+        "Admin": false
+      },
+      "Branch": "master",
+      "Private": false,
+      "Clone": "https://github.com/tektoncd/pipeline.git",
+      "CloneSSH": "git@github.com:tektoncd/pipeline.git",
+      "Link": "https://github.com/tektoncd/pipeline",
+      "Created": "2018-08-29T18:21:55Z",
+      "Updated": "2019-12-04T17:26:42Z"
+    }
+  },
+  "Head": {
+    "Ref": "pr",
+    "Sha": "2a8ec1793553186cf2a027a89ae58a2e690509f3",
+    "Repo": {
+      "ID": "184178909",
+      "Namespace": "wlynch",
+      "Name": "pipeline",
+      "FullName": "wlynch/pipeline",
+      "Perm": {
+        "Pull": false,
+        "Push": false,
+        "Admin": false
+      },
+      "Branch": "master",
+      "Private": false,
+      "Clone": "https://github.com/wlynch/pipeline.git",
+      "CloneSSH": "git@github.com:wlynch/pipeline.git",
+      "Link": "https://github.com/wlynch/pipeline",
+      "Created": "2019-04-30T02:40:49Z",
+      "Updated": "2019-11-22T18:44:26Z"
+    }
+  },
+  "Fork": "wlynch/pipeline",
+  "Link": "https://github.com/tektoncd/pipeline/pull/995.diff",
+  "State": "closed",
+  "Closed": true,
+  "Draft": false,
+  "Merged": true,
+  "Mergeable": false,
+  "Rebaseable": false,
+  "MergeableState": "",
+  "MergeSha": "260c2277fe8ec80b4adc54ccbbfce9bb135f2499",
+  "Author": {
+    "Login": "wlynch",
+    "Name": "",
+    "Email": "",
+    "Avatar": "https://avatars3.githubusercontent.com/u/1844673?v=4",
+    "Link": "https://github.com/wlynch",
+    "Created": "0001-01-01T00:00:00Z",
+    "Updated": "0001-01-01T00:00:00Z"
+  },
+  "Assignees": [
+    {
+      "Login": "vdemeester",
+      "Name": "",
+      "Email": "",
+      "Avatar": "https://avatars0.githubusercontent.com/u/6508?v=4",
+      "Link": "https://github.com/vdemeester",
+      "Created": "0001-01-01T00:00:00Z",
+      "Updated": "0001-01-01T00:00:00Z"
+    },
+    {
+      "Login": "ImJasonH",
+      "Name": "",
+      "Email": "",
+      "Avatar": "https://avatars1.githubusercontent.com/u/210737?v=4",
+      "Link": "https://github.com/ImJasonH",
+      "Created": "0001-01-01T00:00:00Z",
+      "Updated": "0001-01-01T00:00:00Z"
+    },
+    {
+      "Login": "dlorenc",
+      "Name": "",
+      "Email": "",
+      "Avatar": "https://avatars1.githubusercontent.com/u/1714486?v=4",
+      "Link": "https://github.com/dlorenc",
+      "Created": "0001-01-01T00:00:00Z",
+      "Updated": "0001-01-01T00:00:00Z"
+    }
+  ],
+  "Milestone": {
+    "Number": 0,
+    "ID": 0,
+    "Title": "",
+    "Description": "",
+    "Link": "",
+    "State": ""
+  },
+  "Created": "2019-06-20T15:42:17Z",
+  "Updated": "2019-07-03T09:02:49Z"
+}
diff --git a/pullrequest/pr-example/status/cla%2Fgoogle.json b/pullrequest/pr-example/status/cla%2Fgoogle.json
new file mode 100644
index 0000000000..c39f6f96bb
--- /dev/null
+++ b/pullrequest/pr-example/status/cla%2Fgoogle.json
@@ -0,0 +1,6 @@
+{
+  "State": "success",
+  "Label": "cla/google",
+  "Desc": "All necessary CLAs are signed",
+  "Target": ""
+}
diff --git a/pullrequest/pr-example/status/pull-tekton-pipeline-build-tests.json b/pullrequest/pr-example/status/pull-tekton-pipeline-build-tests.json
new file mode 100644
index 0000000000..556ee5c272
--- /dev/null
+++ b/pullrequest/pr-example/status/pull-tekton-pipeline-build-tests.json
@@ -0,0 +1,6 @@
+{
+  "State": "pending",
+  "Label": "pull-tekton-pipeline-build-tests",
+  "Desc": "Job triggered.",
+  "Target": "https://tekton-releases.appspot.com/build/tekton-prow/pr-logs/pull/tektoncd_pipeline/995/pull-tekton-pipeline-build-tests/1146102490727452672/"
+}
diff --git a/pullrequest/pr-example/status/pull-tekton-pipeline-go-coverage.json b/pullrequest/pr-example/status/pull-tekton-pipeline-go-coverage.json
new file mode 100644
index 0000000000..c688921542
--- /dev/null
+++ b/pullrequest/pr-example/status/pull-tekton-pipeline-go-coverage.json
@@ -0,0 +1,6 @@
+{
+  "State": "pending",
+  "Label": "pull-tekton-pipeline-go-coverage",
+  "Desc": "Job triggered.",
+  "Target": "https://tekton-releases.appspot.com/build/tekton-prow/pr-logs/pull/tektoncd_pipeline/995/pull-tekton-pipeline-go-coverage/1146102490727452675/"
+}
diff --git a/pullrequest/pr-example/status/pull-tekton-pipeline-integration-tests.json b/pullrequest/pr-example/status/pull-tekton-pipeline-integration-tests.json
new file mode 100644
index 0000000000..2a7b9d077d
--- /dev/null
+++ b/pullrequest/pr-example/status/pull-tekton-pipeline-integration-tests.json
@@ -0,0 +1,6 @@
+{
+  "State": "pending",
+  "Label": "pull-tekton-pipeline-integration-tests",
+  "Desc": "Job triggered.",
+  "Target": "https://tekton-releases.appspot.com/build/tekton-prow/pr-logs/pull/tektoncd_pipeline/995/pull-tekton-pipeline-integration-tests/1146102490727452674/"
+}
diff --git a/pullrequest/pr-example/status/pull-tekton-pipeline-unit-tests.json b/pullrequest/pr-example/status/pull-tekton-pipeline-unit-tests.json
new file mode 100644
index 0000000000..796bcfd91b
--- /dev/null
+++ b/pullrequest/pr-example/status/pull-tekton-pipeline-unit-tests.json
@@ -0,0 +1,6 @@
+{
+  "State": "pending",
+  "Label": "pull-tekton-pipeline-unit-tests",
+  "Desc": "Job triggered.",
+  "Target": "https://tekton-releases.appspot.com/build/tekton-prow/pr-logs/pull/tektoncd_pipeline/995/pull-tekton-pipeline-unit-tests/1146102490727452673/"
+}
diff --git a/pullrequest/pr-example/status/tide.json b/pullrequest/pr-example/status/tide.json
new file mode 100644
index 0000000000..7543d84f7f
--- /dev/null
+++ b/pullrequest/pr-example/status/tide.json
@@ -0,0 +1,6 @@
+{
+  "State": "pending",
+  "Label": "tide",
+  "Desc": "Not mergeable. Needs lgtm label.",
+  "Target": "https://prow.tekton.dev/tide"
+}
diff --git a/pullrequest/pr.yaml b/pullrequest/pr.yaml
new file mode 100644
index 0000000000..66e6a5da58
--- /dev/null
+++ b/pullrequest/pr.yaml
@@ -0,0 +1,41 @@
+apiVersion: tekton.dev/v1beta1
+kind: Task
+metadata:
+  name: pull-request
+spec:
+  params:
+  - name: mode
+    description: If "download", the state of the pull request at `url` will be fetched. If "upload" then the pull request at `url` will be updated.
+  - name: url
+    description: The URL of the Pull Reuqest, e.g. `https://github.com/bobcatfish/catservice/pull/16`
+  - name: provider
+    description: The type of SCM system, currently `github` or `gitlab`
+  - name: secret-key-ref
+    description: The name of an opaque secret containing a key called "token" with a base64 encoded SCM token
+  - name: insecure-skip-tls-verify
+    description: If "true", certificate validation will be disabled
+    default: "false"
+  workspaces:
+  - name: pr
+  - name: auth-token
+  steps:
+  - name: pullrequest-init
+    image: gcr.io/tekton-releases/github.com/tektoncd/pipeline/cmd/pullrequest-init:v0.11.0-rc1@sha256:62388b0dd5fd3b12444e454cdb6ec967afb557dd2131a9f94bb7bb98761b5f35
+    command: ["/ko-app/pullrequest-init"]
+    env:
+    - name: AUTH_TOKEN
+      valueFrom:
+        secretKeyRef:
+          name: $(params.secret-key-ref)
+          key: token
+    args:
+    - "-url"
+    - "$(params.url)"
+    - "-path"
+    - "$(workspaces.pr.path)"
+    - "-mode"
+    - "$(params.mode)"
+    - "-provider"
+    - "$(params.provider)"
+    - "-insecure-skip-tls-verify"
+    - "$(params.insecure-skip-tls-verify)"
\ No newline at end of file
diff --git a/pullrequest/sample/add-comment.yaml b/pullrequest/sample/add-comment.yaml
new file mode 100644
index 0000000000..4c71502b55
--- /dev/null
+++ b/pullrequest/sample/add-comment.yaml
@@ -0,0 +1,170 @@
+apiVersion: tekton.dev/v1beta1
+kind: PipelineRun
+metadata:
+  generateName: pr-sample-add-comment-
+spec:
+
+  workspaces:
+  # In the future we can have the test infrastructure these in via TriggerBindings
+  - name: pr
+    persistentVolumeClaim:
+      claimName: shared-task-storage
+
+  params:
+  # For now I'm hardcoding a known pull request and will be providing creds only
+  # manually, but in the future we can make the test infrastructure pass params via the bindings
+  # for a PR that can be written to and the token to use
+  - name: url
+    value: https://github.com/bobcatfish/catservice/pull/20
+  - name: secret-key-ref
+    value: webhook-secret
+
+  pipelineSpec:
+    params:
+    - name: url
+      type: string
+    - name: secret-key-ref
+      type: string
+    workspaces:
+    - name: pr
+
+    tasks:
+    # TODO(pipeline#1986) We might be re-using a PVC so we need to make sure
+    # we erase anything on it
+    - name: clear-workspace-before
+      workspaces:
+      - name: w
+        workspace: pr
+      taskRef:
+        name: clear-workspace
+
+    # Get the starting state of the PR
+    - name: pull-request-fetch
+      runAfter: [clear-workspace-before]
+      taskRef:
+        name: pull-request
+      workspaces:
+      - name: pr
+        workspace: pr
+      params:
+      - name: mode
+        value: download
+      - name: url
+        value: $(params.url)
+      - name: provider
+        value: github
+      - name: secret-key-ref
+        value: $(params.secret-key-ref)
+
+    # Check how many comments were on the PR before we did anything so we can
+    # check at the end that one was added successfully
+    - name: count-comments-before
+      runAfter: [pull-request-fetch]
+      taskRef:
+        name: count-comments
+      workspaces:
+      - name: pr
+        workspace: pr
+
+    # Add a comment to the workspace using the current date and time to make it unique
+    - name: add-comment
+      runAfter: [count-comments-before]
+      workspaces:
+      - name: pr
+        workspace: pr
+      taskSpec:
+        workspaces:
+        - name: pr
+        steps:
+        - name: write-comment
+          image: ubuntu
+          script: |
+            #!/usr/bin/env bash
+            set -xe
+
+            NOW=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+            COMMENT="How about right now? It's $NOW"
+            echo $COMMENT > $(workspaces.pr.path)/comments/$NOW
+
+    # Actually update the pull request with the comment
+    - name: pull-request-update
+      runAfter: [add-comment]
+      taskRef:
+        name: pull-request
+      workspaces:
+      - name: pr
+        workspace: pr
+      params:
+      - name: mode
+        value: upload
+      - name: url
+        value: $(params.url)
+      - name: provider
+        value: github
+      - name: secret-key-ref
+        value: $(params.secret-key-ref)
+
+    # Clear the workspace so we can re-fetch the PR and see that it was updated
+    - name: clear-workspace-after
+      runAfter: [pull-request-update]
+      workspaces:
+      - name: w
+        workspace: pr
+      taskRef:
+        name: clear-workspace
+
+    # Grab the new state of the PR
+    - name: pull-request-fetch-after
+      runAfter: [clear-workspace-after]
+      taskRef:
+        name: pull-request
+      workspaces:
+      - name: pr
+        workspace: pr
+      params:
+      - name: mode
+        value: download
+      - name: url
+        value: $(params.url)
+      - name: provider
+        value: github
+      - name: secret-key-ref
+        value: $(params.secret-key-ref)
+
+
+    # Get the number of comments now that we should have added one
+    - name: count-comments-after
+      runAfter: [pull-request-fetch-after]
+      taskRef:
+        name: count-comments
+      workspaces:
+      - name: pr
+        workspace: pr
+
+    # Finally we'll make sure that the number of comments on the PR has
+    # increased, since we added one!
+    - name: check-count
+      runAfter: [count-comments-after]
+      workspaces:
+      - name: pr
+        workspace: pr
+      params:
+      - name: before-count
+        value: "$(tasks.count-comments-before.results.count)"
+      - name: after-count
+        value: "$(tasks.count-comments-after.results.count)"
+      taskSpec:
+        params:
+        - name: before-count
+          type: string
+        - name: after-count
+          type: string
+        workspaces:
+        - name: pr
+        steps:
+        - name: echo
+          image: ubuntu
+          script: |
+            #!/usr/bin/env bash
+            set -xe
+            [[ $(params.after-count) -gt $(params.before-count) ]]
\ No newline at end of file
diff --git a/pullrequest/sample/static.yaml b/pullrequest/sample/static.yaml
new file mode 100644
index 0000000000..8d3b3c4217
--- /dev/null
+++ b/pullrequest/sample/static.yaml
@@ -0,0 +1,48 @@
+apiVersion: tekton.dev/v1beta1
+kind: Task
+metadata:
+  name: count-comments
+spec:
+  results:
+  - name: count
+    description: the number of comments on the PR
+  workspaces:
+  - name: pr
+  steps:
+  - name: count
+    image: ubuntu
+    script: |
+      #!/usr/bin/env bash
+      set -xe
+
+      NUM=$(ls $(workspaces.pr.path)/comments | wc -l )
+      echo -n $NUM > /tekton/results/count
+---
+# TODO(pipeline#1986) Once we have some kind of "auto workspace mode" we can avoid
+# having to manually create a PVC and manually clear it repeatedly
+apiVersion: v1
+kind: PersistentVolumeClaim
+metadata:
+  name: shared-task-storage
+spec:
+  resources:
+    requests:
+      storage: 16Mi
+  volumeMode: Filesystem
+  accessModes:
+    - ReadWriteOnce
+---
+apiVersion: tekton.dev/v1beta1
+kind: Task
+metadata:
+  name: clear-workspace
+spec:
+  workspaces:
+  - name: w
+  steps:
+  - name: clear
+    image: ubuntu
+    script: |
+      #!/usr/bin/env bash
+      set -xe
+      rm -rf $(workspaces.w.path)/*
\ No newline at end of file